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内 容 简 介 


本 书 是 资深 测试 开发 专家 的 经 验 结晶 ， 由 浅 入 深 地 阐释 了 Web 自动 化 测试 的 相关 技术 ,包括 
Web UI 自动 化 测试 、API 自动 化 测试 及 测试 相关 的 基础 开发 。 通 过 学 习 本 书 ， 读 者 可 以 基本 掌握 
Web 测试 相关 的 大 部 分 技术 点 。 本 书 是 测试 相关 人 员 必 备 的 技术 指导 。 书 中 每 个 技术 点 都 有 示例 代 
码 ， 理 论 与 实践 相 结合 的 方式 能 够 使 读者 快速 理解 Web 自动 化 测试 。 

本 书 循序 渐进 地 讲解 了 Web 自动 化 测试 的 各 项 知识 点 ， 使 任何 层级 的 读者 都 能 从 中 受益 。 绪 
论 部 分 介绍 自动 化 方面 的 基础 知识 ， 帮 助 读 者 少 走 弯路 ， 正 确 学 会 自动 化 测试 。 第 1~3 章 介绍 
Selenium、Python 以 及 Web UI 自动 化 的 相关 基础 知识 。 第 4 章 和 第 5 章 介 绍 Selenium IDE 和 
Selenium 常规 对 象 接口 。 第 6 章 介 绍 Web UI 自动 化 特殊 场景 处 理 。 第 7 章 介 绍 UnitTest 单元 测试 框 
架 。 第 8 章 介绍 分 层 框架 设计 与 实现 。 第 9 章 介绍 测试 脚本 的 部 署 。 第 10 章 和 第 11 章 介绍 Web API 
相关 基础 知识 。 第 12 章 介绍 通过 Python 发 送 HTTP 请 求 。 第 13 章 介绍 API 工具 的 设计 与 实现 。 第 
14 章 介 绍 Web 服务 的 集成 工作 。 第 15 章 介 绍 HTTP Mock 的 开发 。 

本 书 适合 Web 测试 人 员 、Web 自动 化 人 员 、Web 开发 人 员 等 初中 级 读者 以 及 希望 使 用 Python 作 
为 编程 语言 的 软件 测试 工程 师 参 考 。 
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Topnice 前 


为 什么 要 写 这 本 书 


作为 一 名 测试 人 员 ， 从 工作 的 第 一 天 开始 我 就 对 自动 化 测试 产生 了 独特 的 兴趣 。 而 最 初 
的 理由 也 很 简单 ， 就 像 开 发 人 员 不 愿意 只 写 业 务 代码 一 样 ， 测 试 人 员 也 不 希望 只 局 限于 手动 
测试 。 自 动 化 测试 对 于 当时 还 是 新 手 测试 人 员 的 我 而 言 ， 完 全 可 以 用 “高 大 上 ”来 形容 。 自 
此 ， 我 便 在 学 习 和 实践 自动 化 测试 的 道路 上 越 走 越 远 。 

而 随 着 计算 机 技术 及 互联 网 的 发 展 ， 如 今 作为 一 名 测试 人 员 ， 不 仅 要 掌握 针对 于 业务 流 
程 的 手动 测试 方法 和 理论 ; 还 要 具备 一 定 的 自动 化 、 性 能 的 测试 能 力 。 甚 至 于 在 找 工 作 时 会 
写 脚 本 ， 会 使 用 自动 化 工具 进行 测试 已 经 成 为 测试 人 员 的 一 种 标 配 。 本 书 总 结 了 作者 在 项 目 
实践 中 的 多 年 工作 经 验 ， 梳 理 了 自动 化 测试 需要 掌握 的 一 些 基本 技能 和 知识 ， 帮 助 初级 测试 
人 员 快 速 掌握 目前 常用 的 自动 化 测试 手段 和 方法 ， 提 高 自身 的 综合 技能 水 平 。 

自动 化 测试 对 于 测试 新 人 而 言 ， 往 往 会 理解 为 手动 功能 测试 的 自动 化 实现 。 比 如 : UI 自 
动 化 测试 。 但 从 广义 概念 来 看 ， 自 动 化 测试 还 要 包括 : 接口 自动 化 、 性 能 自动 化 、 白 盒 自动 
化 、 安 全 自动 化 、 自 动 化 工具 /框架 /平台 等 一 系列 可 以 通过 开发 脚本 来 实现 的 测试 。 而 本 
书 所 讲 到 的 自动 化 测试 内 容 包 括 : UI 自动 化 、 自 动 化 框架 、 接 口 自动 化 、 自 动 化 工具 、 自 动 
化 持续 集成 等 相关 知识 。 目 的 是 给 读者 打开 一 个 通 向 更 加 广泛 的 自动 化 测试 之 门 。 

此 外 ， 对 于 一 些 刚 开始 接触 自动 化 测试 的 人 员 而 言 ， 自 动 化 测试 几乎 等 同 于 高 效 测试 。 
其 实现 项 目 中 并 没有 想象 的 那么 美好 ， 自 动 化 测试 需要 根据 不 同 的 场景 和 需求 来 定制 不 同 的 
自动 化 测试 方案 。 本 书 最 开始 的 部 分 就 介绍 了 自动 化 测试 的 方法 论 和 最 佳 实践 ， 避 免 测试 新 
人 误 入 自动 化 测试 的 “陷阱 ”。 

另外 ， 本 书 也 是 一 本 Python 的 基础 学 习 教程 ， 作 为 Python 的 铁杆 粉丝 ， 自 然 也 希 
望 能 够 将 Python 语言 最 大 程度 地 推广 到 自动 化 测试 领域 中 来 。 正 所 谓 “ 人 生 苦 短 ， 我 用 
Python !” 
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本 书 特色 

1. 附带 读书 兴趣 小 组 ， 方 便 学 习 沟 通 

为 了 便于 读者 相互 沟通 ， 提 高 学 习 效率 ， 作 者 专门 为 本 书 建 设 了 读书 兴趣 小 组 ， 读 者 可 
以 通过 登录 testqa.cn 并 加 入 seleniumbook 小 组 来 学 习 和 交流 。 另 外 本 书 中 的 源码 包 也 会 在 这 
个 小 组 中 支持 下 载 。 

2. 涵盖 多 种 自动 化 测试 方法 

本 书 涵盖 自动 化 测试 中 使 用 到 的 多 种 测试 方法 ， 除 了 UI 的 自动 化 ， 还 包括 接口 自动 化 ， 
测试 工具 开发 、CI 的 使 用 。 

3. 对 Selenium 工具 的 历史 和 原理 进行 了 分 析 与 说 明 

除了 对 于 Selenium 工具 ， 提 供 相 关 接 口 的 实例 代码 外 ， 还 介绍 了 Selenium 的 历史 和 基 
本 原理 。 使 得 读者 在 学 习 的 过 程 中 ， 知 其 然 也 知 其 所 以 然 。 另 外 对 Selenium IDE 的 操作 和 使 
用 也 做 了 较为 详尽 的 说 明 ， 使 得 初学 者 也 可 以 快速 上 手 和 使 用 Selenium 进行 自动 化 测试 的 
实践 。 

4. 介绍 详尽 框架 的 开发 

本 书 除了 介绍 Selenium 的 一 些 基本 接口 之 外 ， 还 介绍 了 在 基于 Selenium 的 情况 下 ， 如 
何 搭建 可 用 性 较 高 的 测试 基础 框架 。 使 用 分 层 架 构 、 数 据 驱 动 、 业 务 解 耦 、 功 能 封装 等 方 
式 ， 让 UI 自动 化 测试 不 再 是 “可 远 观 而 不 可 询 玩 ”的 技术 。 

5. 总 结 自动 化 最 佳 实践 

本 书 的 开头 并 没有 一 上 来 就 开展 技术 的 介绍 ， 而 是 先 从 方法 论 和 最 佳 实践 开始 。 目 的 是 
让 读者 先 理解 “ 道 ”， 再 学 习 “ 术 ”。 这 样 才能 更 好 地 学 习 和 真正 地 利用 自动 化 的 相关 测试 技 
术 。 避 免 测试 新 人 误 入 自动 化 的 “陷阱 ”。 

6. 提供 基础 的 Python 教程 

除了 介绍 自动 化 相关 的 测试 技术 ， 本 书 还 涵盖 了 书 中 其 他 地 方 需要 用 到 的 Python 编程 
基础 知识 。 为 的 是 让 读者 只 需 一 本 书 就 可 以 开始 步 入 自动 化 测试 的 行列 。 

7. 提供 完善 的 技术 支持 和 售后 服务 

本 书 提供 了 专门 的 技术 支持 邮箱 : five3@163.com。 读 者 在 阅读 本 书 过 程 中 有 任何 疑问 
都 可 以 通过 该 邮箱 获得 帮助 。 


读者 对 象 
口 希望 学 习 自动 化 测试 技术 的 测试 人 员 ; 
口 希望 提升 自身 技术 的 测试 人 员 ; 
口 希 望 了 解 自动 化 测试 技术 的 开发 人 员 ; 
口 其 他 希望 利用 自动 化 技术 的 相关 人 员 。 


本 书 主要 内 容 

本 书 分 为 三 大 部 分 。 

第 一 部 分 为 方法 论 ， 主 要 介绍 入 门 自动 化 测试 之 前 需要 了 解 的 相关 方法 论 和 最 佳 实践 。 

第 二 部 分 为 Selenium 介绍 ， 着 重 讲解 Selenium 的 历史 、 原 理 、IDE 和 接口 的 使 用 ， 同 
时 还 介绍 了 基于 Selenium 的 自动 化 框架 搭建 。 

第 三 部 分 为 工具 开发 介绍 ， 通 过 一 步 步 深入 的 介绍 带领 读者 进行 接口 测试 工具 、mock 
测试 工具 的 开发 ， 同 时 集成 到 Web 服务 中 。 

除了 这 三 个 主要 部 分 之 外 ， 还 会 有 一 些 其 他 的 自动 化 相关 知识 ， 各 自分 散在 不 同 的 章节 
中 。 比 如 : CI 持续 集成 的 使 用 ， 基 础 环境 的 搭建 ，Python 语言 的 学 习 等 。 如 果 你 是 一 名 初学 
者 ， 建 议 从 第 1 章 开 始 学 习 。 


阅读 本 书 的 建议 
口 测试 新 手 读者 ， 建 议 从 第 1 章 顺 次 阅读 。 
口 有 一 定 Python 基础 的 读者 ， 可 以 根据 实际 情况 有 重点 地 选择 阅读 各 个 技术 要 点 。 
口 在 学 习 框 架 之 前 ， 需 要 保证 对 Selenium 和 Python 语法 章节 有 了 一 定 的 掌握 ; 先 通读 
一 遍 有 个 大 概 印象 ， 然 后 将 每 个 知识 点 的 示例 代码 都 在 开发 环境 中 操作 一 遍 ， 加 深 对 
知识 点 的 印象 。 
口 结合 github 中 的 完整 代码 来 实际 操作 ， 这 样 理解 起 来 就 更 加 容易 ， 也 会 更 加 深刻 。 


进一步 学 习 建议 

当 您 阅读 完 本 书后 ， 相 信 已 经 掌握 了 Python Web 自动 化 测试 的 基本 知识 。 但 如 果 还 要 
更 进一步 深入 下 去 ， 还 必须 要 进一步 地 掌握 Python 的 开发 技术 ， 以 及 加 深 对 自动 化 测试 的 
理解 。 掌 握 了 扎实 的 技术 能 力 之 后 ， 针 对 项 目 中 需要 提炼 的 流程 和 事务 ， 进 行 分 析 并 有 针对 
性 地 优化 。 做 好 自动 化 项 目 最 重要 的 一 点 就 是 : 结合 实际 业务 需求 ， 否 则 可 能 就 成 为 “空中 

此 外 还 需要 学 习性 能 、 白 盒 、 安 全 等 相关 测试 技术 ， 结 合 自动 化 来 提升 这 些 测试 过 程 中 
的 效率 。 比 如 : 测试 数据 的 准备 、mock 系统 的 开发 、 代 理 监听 、 信 息 采集 等 。 

如 果 和 希望 在 Python 编程 方面 有 更 多 的 提升 ， 推 荐 去 阅读 Python 核心 编程 方面 的 书籍 ， 
而 对 于 项 目 中 的 效率 提升 则 需要 自己 更 多 地 去 实践 、 学 习 和 思考 。 


勘误 和 支持 
由 于 作者 的 水 平 有 限 ,编写 时 间 仓 促 ， 书 中 难免 会 出 现 一 些 错误 或 者 不 准确 的 地 方 ， 屋 


请 读者 批评 指正 。 为 此 ， 特 意 创建 一 个 在 线 支 持 与 应 急 方 案 的 二 级 站 点 http://www.testqa.cn/ 
seleniumbook。 你 可 以 将 书 中 的 错误 发 布 在 Bug 勘误 表 页 面 中 ， 同 时 如 果 你 遇 到 任何 问题 ， 


IV 六 Python Web 自动 化 测试 设计 与 实现 


也 可 以 访问 seleniumbook 小 组 页 面 ， 我 将 尽量 在 线 上 为 读者 提供 最 满意 的 解答 。 书 中 的 全 部 
源 文件 除 可 以 从 github ( http://github.com/five3 ) 下 载 外 ， 还 可 以 从 testqa 站 点 下 载 ， 我 也 会 
及 时 更 新 相应 的 功能 。 如 果 你 有 更 多 的 宝贵 意见 ， 也 欢迎 通过 清华 大 学 出 版 社 网 站 ( www. 
tup.com.cn) 与 我 们 联系 ， 期 待 能 够 得 到 你 们 的 真挚 反馈 。 
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自动 化 测试 与 其 他 技术 工作 相 比 有 着 自己 的 独特 性 ， 它 不 同 于 纯 开发 或 者 测试 ， 在 有 工 
作 量 投入 的 前 提 下 就 必定 有 对 应 的 产 出 ， 所 以 在 正式 学 习 这 项 技术 之 前 ， 有 必要 对 其 进行 一 
番 真 切 的 认识 ， 让 我 们 不 仅 能 够 学 习 这 门 技术 ,更 能 把 这 门 技 术 运 用 到 正确 的 项 目 中 。 

开发 的 直接 产 出 、 最 终 产 出 都 是 代码 。 测 试 的 直接 产 出 、 最 终 产 出 都 是 测试 覆盖 的 程 
序 。 自 动 化 测试 的 直接 产 出 是 脚本 ， 而 最 终 产 出 却 是 效率 。 所 以 如 果 自 动 化 测试 没有 产 出 效 
率 则 表示 没有 最 终 产 出 ， 此 时 的 直接 产 出 就 没有 意义 了 。 这 正 是 自动 化 测试 的 特殊 之 处 。 

因此 ， 本 书 在 一 开始 就 针对 如 何 更 好 地 运用 自动 化 测试 技术 展开 了 一 番 论 述 ， 把 以 前 踩 
过 的 坑 、 趟 过 的 河 以 及 行业 内 的 共同 认 知 进行 了 整理 归纳 ; 希望 能 让 新 人 在 以 后 的 项 目 中 尽 
量 避 免 这 些 误区 ， 少 走 些 弯路 ， 这 样 才 能 让 自动 化 技术 真正 地 发 挥 它 本 来 的 作用 。 


如 何 学 习 自 动 化 

近 些 年 来 作为 一 名 软件 测试 人 员 ， 掌 握 一 门 过 硬 的 自动 化 技术 是 必 不 可 少 的 。 无 论 是 UI 
自动 化 、 接 口 自动 化 还 是 性 能 自动 化 ， 至 少 需要 掌握 一 种 技术 。 对 于 此 前 以 手工 测试 为 主 或 
者 应 届 大 学 生 而 言 ， 怎 样 才能 学 好 自动 化 技术 则 是 首要 问题 。 由 于 本 书 主要 介绍 UI 和 API 
的 自动 化 ， 所 以 接 下 来 所 讲 的 方法 也 是 针对 这 些 方面 的 。 

首先 ， 在 学 习 自动 化 之 前 要 有 足够 的 意愿 和 信心 ， 也 就 是 说 为 了 提升 自己 而 主动 学 习 
而 非 外 力 压迫 去 学 习 。 这 样 在 学 习 的 过 程 中 即使 有 困难 和 不 顺 你 都 可 以 坚持 和 跨越 过 去 ， 否 
则 可 能 一 个 小 小 的 挫折 就 让 你 放弃 其 至 厌恶 学 习 自 动 化 。 学 习 自动 化 技术 是 一 件 需 要 坚持 的 
事情 ， 只 有 不 忘 初 心 ， 才 能 方 得 始终 ! 
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其 次 ， 需 要 掌握 一 些 编程 基础 ， 例 如 一 门 编程 语言 ， 如 Python 、Java、C#、Ruby 等 。 

具体 需要 掌握 哪 种 语言 主要 取决 于 选择 的 自动 化 技术 。 例 如 ， 如 果 使 用 QTP 则 需要 掌握 
VBS， 使 用 Watir 则 需要 掌握 Ruby， 而 使 用 Selenium 则 上 面 提 到 的 几 种 语言 都 可 以 。 此 外 ， 
可 能 还 需要 掌握 数据 库 的 基本 使 用 方法 ， 知 道 如 何 通 过 自己 熟悉 的 语言 去 操作 各 种 不 同 的 数 
据 库 。 还 需要 掌握 一 些 基 本 的 操作 系统 知识 、 基 本 算法 等 。 
再 次 ,需要 了 人 解 所 测试 的 对 象 使 用 的 一 些 技术 ,例如 ， 要 对 Web 项 目 进行 自动 化 测试 ， 
那么 需要 掌握 HTTP、HTML、JavaScript、CSS 等 Web 开发 的 相关 知识 ， 理 解 它 的 运行 机 制 
和 原理 ， 这 样 才能 在 进行 自动 化 学 习 的 过 程 中 平稳 而 顺利 地 前 进 ; 否则 ， 可 能 遇 到 很 多 莫名 
其 妙 、 不 得 其 解 的 现象 或 问题 。 

最 后 ， 如 果 满 足 了 上 述 基 本 要 求 ， 那 么 恭喜 你 已 经 可 以 开始 自己 的 自动 化 测试 之 旅 了 。 
可 以 从 最 开始 的 环境 搭建 ， 到 demo 样 例 ， 再 到 常用 函数 的 学 习 、 简 单 场景 的 实现 、 多 个 场 
景 的 实现 、 批 量 运行 、 框 架设 计 等 ， 一 步 步 学 习 。 这 期 间 每 一 次 的 运行 成 功 都 会 提升 你 的 自 
信心 ， 而 每 一 次 的 执行 失败 则 考验 着 你 能 否 最 终 进 阶 到 自动 化 测试 工程 师 。 在 这 里 作者 希 
望 读者 在 学 习 时 不 要 害怕 、 厌 恶 过程 中 出 现 的 错误 和 问题 ， 要 积极 主动 地 找到 问题 的 原因 并 
最 终 解 决 问题 。 每 当 解决 一 个 问题 之 后 ， 离 成 功 就 更 进一步 了 。 另 外 ， 如 果 你 身边 有 技术 大 
牛 ， 可 以 向 他 请 教学 习 ， 但 切记 不 要 一 遇 到 问题 就 去 寻找 帮助 ， 需 要 给 自己 一 个 思考 的 机 
会 ， 也 需要 适度 地 消费 技术 大 牛 们 的 耐心 和 时 间 。 


自动 化 项 目 选 型 


尽管 软件 测试 人 员 对 自动 化 技术 趋 之 若 歼 ,但 自动 化 技术 本 身 不 是 万 能 的 ， 并 不 是 所 有 
的 项 目 都 适合 自动 化 测试 ; 所 以 在 进行 自动 化 项 目 选 项 的 时 候 就 需要 进行 一 下 条 件 筛选 ， 看 
下 是 否 满足 进行 自动 化 的 条 件 ， 这 样 不 仅 能 让 我 们 的 自动 化 技术 有 施展 的 空间 ， 也 能 让 自动 
化 测试 技术 带 来 实 实在 在 的 效益 。 下 面 就 列 出 一 些 符合 自动 化 测试 技术 应 用 的 项 目 特点 。 


周期 长 且 需 求 稳定 


即 项 目 本 身 是 一 个 长 期 规划 的 ， 而 不 是 短期 的 或 者 是 新 项 目 ， 因 为 开发 测试 脚本 也 是 需 
要 时 间 的 ， 这 个 投入 就 需要 在 后 期 反复 回归 测试 时 补 回来 ， 如 果 项 目 周 期 不 是 足够 长 的 话 ， 
可 能 脚本 没有 开发 完 项 目 就 结束 了 ; 需求 稳定 指 的 是 项 目 在 长 期 的 进行 过 程 中 不 会 大 量 或 者 
频繁 地 修改 需求 ， 因 为 一 旦 需求 改变 了 ， 意 味 着 之 前 的 测试 脚本 都 将 不 可 用 ， 也 就 无 法 完成 
测试 脚本 的 积累 ， 最 终 也 可 能 导致 项 目 结束 但 脚本 却 没 写 完 ， 或 者 真正 在 执行 测试 的 脚本 少 
大 又 消 。 
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功能 模块 有 回归 需求 


编写 自动 化 脚本 目的 是 提高 测试 效率 ， 只 有 测试 脚本 被 反复 使 用 时 ， 测 试 效率 才能 最 大 
化 地 提升 ;试想 如 果 测 试 脚本 只 被 使 用 几 次 ， 即 使 效率 提高 了 也 是 很 有 限 的 ， 但 是 开发 脚本 
的 成 本 却 是 很 高 的 ， 所 以 被 测试 项 目 对 功能 模块 回归 的 需求 很 大 程度 上 决定 了 实施 自动 化 测 
试 的 意义 。 


操作 场景 易于 自动 化 


这 里 主要 指 的 是 某 些 特殊 场景 可 能 在 人 为 的 情况 下 很 难 实现 ， 或 不 易 完 成 的 场景 ， 例 
如 ， 快 频次 的 反复 操作 、 大 量 的 文本 输入 、 精 确 的 单 击 、 大 量 的 数字 计算 操作 等 。 这 些 操作 
场景 有 些 人 为 做 不 到 ， 有 些 人 为 易 出 错 ， 但 是 使 用 自动 化 技术 则 可 以 很 容易 实现 这 样 的 需 
求 。 如 果 项 目 中 有 大 量 这 样 的 场景 ， 那 么 自动 化 测试 技术 则 是 不 二 选择 。 


自动 化 的 正确 打开 方式 


上 面 只 是 从 一 个 宏观 的 角度 来 审视 一 个 项 目 是 否 适合 自动 化 。 接 下 来 就 从 细节 上 来 阐述 
下 如 何 才能 更 好 地 实施 自动 化 ， 在 具体 的 自动 化 执行 过 程 中 需要 关注 哪些 点 ， 从 而 避免 误 入 
自动 化 测试 的 陷阱 里 。 这 里 总 结 了 10 条 参考 建议 。 


考虑 成 本 效益 


成 本 效益 即 通常 所 说 的 RIO (Return On Investment， 投 资 回报 率 )， 在 自动 化 测试 中 这 个 
概率 必须 要 牢记 ， 因 为 自动 化 测试 的 初衷 是 为 了 提高 效率 和 节约 成 本 ， 如 果 最 终 都 没 能 达成 
则 表示 自动 化 是 失败 的 。 因 此 在 考虑 是 否 要 进行 自动 化 测试 的 时 候 ， 需 要 优先 核算 RIO 而 不 
能 误 入 为 了 自动 化 而 自动 化 的 陷阱 。 

自动 化 测试 的 投资 主要 为 测试 脚本 开发 、 维 护 的 人 力 成 本 ， 而 自动 化 测试 的 回报 为 每 次 
执行 脚本 所 节约 的 人 力 成 本 ; 做 一 个 简单 的 计算 就 是 脚本 开发 和 维护 的 总 成 本 不 应 大 于 自动 
化 测试 所 能 节约 的 总 成 本 。 可 以 简单 地 理解 为 如 下 公式 : 

自动 化 测试 工程 师 总 人 天 数 < 自动 化 单 次 平均 节约 人 天 数 x 执行 次 数 

从 公式 中 可 以 得 出 如 下 结论 。 

口 执行 次 数 越 多 越 好 。 

口 有 一 个 收回 成 本 的 临界 点 。 
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口 执行 次 数 至 少 大 于 这 个 临界 点 才能 节约 成 本 。 

从 这 里 可 以 得 出 为 什么 项 目 周 期 需要 足够 长 ， 且 项 目 功能 需要 稳定 ; 因为 项 目 周 期 越 长 、 
可 回归 的 次 数 越 多 ， 则 自动 化 脚本 执行 的 次 数 就 越 多 ， 自 动 化 测试 得 到 的 回报 就 会 越 高 ， 自 
动 化 测试 才能 真正 地 发 挥 价值 。 那 么 问题 来 了 ， 如 果 你 的 老板 或 上 司 需要 你 开展 自动 化 测 
试 ， 你 应 该 怎么 跟 他 保证 呢 ? 


提示 这 里 需要 辩证 地 对 待 这 个 问题 ， 既 不 能 打包 票 也 不 能 一 味 儿 推脱 ， 因 为 UI 自动 
化 测试 的 风险 还 是 有 的 ， 并 不 是 任何 一 个 项 目 都 是 适合 进行 UI 自动 化 ， 所 以 一 旦 遇 到 类 似 
的 情况 ， 我 们 需要 询问 在 下 面 的 几 个 场景 中 ， 作 为 自动 化 测试 的 效果 来 看 ， 最 低 可 以 接受 的 
选项 是 哪个 ? 

口 提高 测试 工作 的 效率 。 

口 增加 测试 工作 的 覆盖 率 。 

口 节约 测试 工作 的 总 成 本 。 

口 以 上 三 者 5 


针对 提示 中 提 到 的 选项 ， 相 信 大 多 数 人 的 期 望都 是 第 4 项 ， 而 实际 的 测试 项 目 中 能 达到 
第 4 项 的 项 目 并 不 多 , 但 是 这 并 不 意味 着 达 不 到 这 个 效果 就 直接 放弃 掉 UI 自动 化 测试 。 因 
为 有 时 候 我 们 是 需要 付出 成 本 来 换取 时 间 ， 例如， 为 了 缩短 项 目的 回归 周期 ， 有 时 候 是 需要 
付出 成 本 来 提高 产品 测试 覆盖 率 ， 例 如 ， 银 行 系统 的 准确 性 。 使 用 不 同 的 需求 来 裁定 自动 化 
测试 是 否 有 效 ， 才 是 正确 的 投资 回报 的 体现 。 


选择 合适 的 工具 

正如 前 面 所 提 到 的 广义 的 自动 化 测试 包括 很 多 : 功能 、 性 能 和 安全 等 ， 不 同 的 自动 化 类 
型 需要 选择 不 同 的 测试 工具 。 即 便 是 本 书 中 重点 讲解 的 功能 自动 化 也 是 如 此 ， 针 对 不 同 的 项 
目 类 型 需要 进行 最 佳 工具 的 选择 。 

功能 自动 化 测试 工具 有 很 多 ， 从 是 否 收费 来 分 可 以 分 为 : 商业 、 开 源 工具 ; 从 被 测 对 象 
来 分 可 以 分 为 : Windows、Web 工具 ; 从 测试 阶段 来 分 可 以 分 为 : 白 盒 、 接 口 、GUI 工 具 。 
因此 , 项 目的 诉求 不 同 、 类 型 不 同 、 阶 段 不 同 ， 所 选取 的 工具 是 不 一 样 的 。 

如 果 是 公司 没有 购买 工具 的 预算 ， 则 开源 工具 是 首选 ; 如 果 是 Windows 的 程序 ， 则 可 能 
会 考虑 QTP、Rational、UIAutomation 等 ; 如 果 是 Web 程序 ， 则 大 多 会 选择 Selenium、Watir 
等 ; 如 果 是 接口 测试 ， 则 可 以 选择 SoapUI; 正常 情况 下 ， 都 是 可 以 选择 到 一 款 合适 的 测试 工 
具 的 。 
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在 选择 工具 的 时 候 ， 除 了 上 面 提 到 的 项 目 属性 之 外 ， 还 需要 考虑 工具 的 脚本 开发 语言 、 
可 扩展 性 、 支 持 的 外 部 接口 、 与 其 他 工具 的 集成 度 等 方面 的 因素 。 


适当 分 层 测试 
在 自动 化 测试 领域 有 一 个 很 出 名 的 模型 : 倒 三 角 模型 ， 如 图 0-1 所 示 。 


单元 测试 
易 | 快 


0-1 测试 倒 三 角 


图 0-1 中 把 自动 化 测试 依据 不 同 的 测试 阶段 分 为 : 单元 测试 、 集 成 测试 、 验 收 测试 ;每 
个 阶段 自动 化 测试 的 维护 成 本 是 递增 的 ， 而 奇怪 的 是 我 们 通常 的 自动 化 覆盖 程度 也 是 递增 
的 。 即 单元 测试 维护 成 本 最 低 ， 它 的 覆盖 率 〈 阴 影 面积 ) 也 是 最 低 的 ; 虽然 这 是 实际 中 经 常 
发 生 的 情况 ， 但 却 不 是 所 希望 的 情况 。 
正常 情况 应 该 是 维护 成 本 越 低 的 层次 ， 其 覆盖 率 越 高 越 好 ; 理想 的 不 同 阶段 测试 覆盖 率 
的 关系 如 图 0-2 所 示 。 


难 { 慢 

验收 测试 
维 | 运 
护 | 行 

集成 测试 
易 | 快 


图 0-2 测试 黄金 三 角 
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这 就 是 分 层 测试 的 原型 ， 我 们 在 对 项 目 进行 自动 化 实施 之 前 ， 都 应 该 考虑 分 层 测试 的 可 
能 性 和 必要 性 ， 尽 可 能 把 需要 测试 的 内 容 放 在 底层 测试 阶段 ， 只 有 少 部 分 的 测试 在 上 层 的 测 
试 阶段 ， 这 样 不 仅 提 高 了 整体 测试 的 稳定 性 和 测试 效率 ， 同 时 也 降低 了 自动 化 测试 的 难度 。 


提高 被 测 系统 的 可 测 性 


通常 情况 下 ， 一 个 系统 是 否 可 测 不 仅 取决 于 所 采用 的 自动 化 测试 技术 ， 同 时 也 取决 于 系 
统 架 构 和 开发 对 可 测 性 的 支持 ; 对 于 标准 的 控件 而 言 ， 需 要 开发 人 员 在 设计 和 编码 阶段 提供 
良好 的 自动 化 命名 规范 ， 例 如 ，Web 控件 添加 ID 属性 ; 而 对 于 大 量 使 用 非 标准 化 控件 的 系 
统 来 说 ， 如 果 要 让 它 可 以 支持 自动 化 测试 ， 可 以 部 分 地 考虑 开放 API， 部 分 使 用 GUI 操作 结 
合 起 来 使 用 。 

除了 上 述 提 到 的 被 测 系 统 本 身 的 可 测 性 ， 还 有 就 是 通过 增强 测试 技能 来 提高 系统 的 可 测 
性 。 例 如 ， 测 试 某 个 系统 的 多 线程 读 写 同步 ， 常 规 的 自动 化 工具 一 般 不 支持 这 样 的 功能 ， 那 就 
要 测试 人 员 自 己 编写 多 线程 读 写 的 程序 来 调用 被 测试 系统 ， 通 过 控制 线程 的 读 写 顺序 来 验证 预 
期 的 结果 。 又 如 ， 被 测 场景 是 一 个 很 多 步 又 之 后 才 会 出 现 的 ， 如 果 按 照 正常 操作 会 大 大 增加 测 
试 的 不 稳定 性 ， 这 时 可 以 利用 一 些 HACK 的 方式 绕 过 前 面 步 又， 直接 到 达 被 测 场景 进行 测试 。 

因此 广义 上 的 提高 可 测 性 是 指 能 够 使 原本 不 容易 测试 、 不 可 测试 的 系统 变 得 可 测 所 使 用 
的 一 切 方 法 和 技术 。 


没有 必要 的 完全 自动 化 

很 多 时 候 刚 开始 使 用 自动 化 测试 技术 的 测试 人 员 都 会 掉 进 一 个 怪圈 ， 认 为 做 自动 化 测试 
理 所 应 当 就 应 该 尽量 全 部 地 自动 化 ， 哪 怕 某 些 场景 即使 不 是 特别 适合 自动 化 。 例 如 ， 某 些 场 
景 的 结果 是 动态 变化 的 ， 或 者 某 些 场景 需要 跨越 多 个 平台 操作 ， 这 些 就 不 适合 自动 化 去 进行 
测试 。 

人 有 人 的 优势 ， 机 器 有 机 器 的 优势 ， 在 进行 项 目测 试 的 时 候 也 要 辩证 地 考虑 这 个 实际 问 
题 ， 不 要 一 味 地 追求 完全 的 自动 化 ， 而 要 酌情 考虑 哪些 工作 更 适合 机 器 去 做 ， 哪 些 工 作 更 适 
合 人 去 进行 。 例 如 ， 重 复 的 固定 流程 、 反 复 的 单 击 操作 等 就 比较 适合 自动 化 ， 而 对 于 变化 的 
或 者 需要 思考 逻辑 的 场景 就 需要 测试 人 员 来 进行 。 


尽 可 能 优化 时 间 
对 于 单一 的 自动 化 用 例 而 言 ， 可 能 党 得 执行 的 不 是 很 慢 ， 即 使 在 用 例 中 还 使 用 了 延 时 等 
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待 的 技术 ; 但 是 当 自 动 化 测试 用 例 数 量变 得 庞大 的 时 候 ， 就 会 发 现 自动 化 测试 的 执行 时 间 
始 成 为 瓶颈 ; 因为 总 是 希望 尽 可 能 早 地 获取 到 自动 化 测试 的 反馈 结果 ， 而 当 我 们 一 旦 完成 了 
主 功能 的 自动 化 之 后 ， 再 加 上 对 平台 的 兼容 性 的 支持 ， 那 么 自动 化 用 例 的 数量 就 会 成 倍 地 增 
长 ， 这 时 自动 化 用 例 的 执行 速度 就 会 显得 比较 重要 。 

总 而 言 之 ,不 论 对 于 大 的 系统 还 是 小 的 系统 ， 自 动 化 用 例 一 次 回归 执行 时 间 不 应 大 于 一 
个 昼夜 的 长 度 ; 通常 就 是 下 班 前 启动 自动 化 测试 的 执行 ， 到 第 二 天 早上 上 班 后 能 收 到 自动 化 
测试 的 测试 报告 邮件 。 对 于 用 例 数量 较 少 的 情况 ， 通 常 都 是 很 容易 办 到 的 ， 而 对 于 用 例 数 量 
较 大 的 系统 又 该 怎么 办 呢 ? 


提示 “提高 执行 脚本 的 效率 可 以 从 宏观 和 微观 两 个 方面 来 考虑 ; 宏观 指 的 是 从 用 例 的 执 
行 策略 上 考虑 ， 微 观 指 的 是 从 单个 用 例 上 来 考虑 。 下 面 的 优化 项 可 以 用 来 参考 。 

口 取消 每 一 个 用 例 中 的 过 长 等 待 时 间 ， 替 换 为 waitFor 函数 。 

口 尽 可 能 减少 到 达 最 终 测试 场景 的 步骤 。 

口 单个 用 例 中 尽 可 能 多 地 设置 检查 点 ， 避 免 一 个 用 例 只 设置 一 个 检查 点 。 

口 把 没有 互 斥 影响 的 用 例 分 布 到 多 台 机 器 执行 。 

口 根据 不 同 的 测试 需求 划分 不 同 数量 级 的 用 例 集合 ， 根 据 需求 执行 对 应 的 用 例 集 。 

口 提高 小 数量 用 例 集 的 执行 频率 ， 降 低 大 数量 用 例 集 的 执行 频率 。 


最 少 步骤 进入 到 被 测 场景 


正常 情况 下 人 工 执行 测试 时 都 是 按照 正常 的 业务 场景 来 进行 的 ， 如 果 到 达 被 测 场景 需要 
执行 10 步 操作 ， 我 们 就 会 完整 地 走 完 这 10 步 ; 这 种 方式 对 于 手动 测试 来 说 是 没有 任何 问题 
的 ， 因 为 测试 人 员 会 有 能 动 性 ， 他 们 会 把 前 面 9 步 走 到 场景 全 部 顺带 都 测试 一 遍 ， 然 后 到 达 
第 10 步 的 场景 。 而 我 们 在 编写 自动 化 脚本 的 时 候 就 不 能 这 样 写 代码 ， 那 样 的 话 一 个 自动 化 
用 例 就 会 变 得 很 大 ， 既 不 利于 后 期 的 维护 ， 也 不 利于 用 例 的 顺利 执行 ， 因 为 如 果 执 行 没有 一 
次 性 全 部 通过 ， 整 个 用 例 就 会 中 断后 面 的 执行 。 

因此 每 一 个 自动 化 用 例 都 是 一 个 独立 的 场景 ， 用 例 自身 的 失败 不 会 干扰 其 他 用 例 的 正 
常 执行 ; 也 因此 导致 很 多 场景 的 元 余 和 重 倒 ， 通 常 我 们 都 是 作为 公共 的 业务 场景 进行 提取 
出 来 ， 这 样 在 代码 层面 上 是 可 以 理解 的 ; 但 是 在 执行 时 元 余 的 场景 还 是 会 被 不 断 重复 执行 ， 
这 样 一 方面 会 导致 执行 时 间 变 长 ， 另 一 方面 也 增加 了 用 例 执 行 的 不 稳定 性 ; 所 以 在 设计 自 
动 化 测试 用 例 的 时 候 ， 在 保证 覆盖 了 手工 场景 的 前 提 下 ， 要 以 最 少 的 步骤 进入 到 正式 的 被 
测 场 景 。 


8 冰 Python Web 自动 化 测试 设计 与 实现 


持续 进行 集成 测试 


在 上 面 提 到 的 几 条 里 面 都 有 一 个 基本 的 前 提 ， 那 就 是 用 例 的 持续 执行 ， 因 为 如 果 不 进行 
用 例 的 持续 执行 ， 就 不 会 知道 执行 的 总 体 时 间 有 没有 超时 ， 也 不 会 知道 哪些 场景 比较 稳定 ， 
甚至 都 不 会 知道 用 例 在 批量 执行 的 情况 下 能 不 能 顺利 地 执行 完 。 

所 以 自动 化 用 例 的 持续 执行 与 自动 化 用 例 的 开发 一 样 重 要 ， 如 果 只 是 开发 了 自动 化 脚本 
而 没有 持续 的 执行 ， 那 么 工作 最 多 只 完成 了 30% ; 后 面 更 多 的 调试 、 维 护 工作 才 是 自动 化 测 
试 能 否 成 功 的 关键 所 在 ， 而 一 旦 脱离 了 持续 执行 ， 那 么 一 切 将 无 从 谈 起 。 


快速 修复 失败 脚本 


持续 地 执行 自动 化 测试 的 目的 是 为 了 尽早 发 现 用 例 在 运行 时 可 能 出 现 的 问题 ， 如 果 发 现 
了 问题 ， 那么 接 下 来 要 做 的 就 是 快速 修复 问题 ， 毕 况 有 问题 不 修复 其 危害 性 就 等 同 于 没有 持 
续 地 执行 自动 化 测试 。 

持续 执行 自动 化 测试 其 实 就 是 在 分 阶段 地 去 发 现 问题 ， 而 跟 它 配套 的 就 是 紧 跟 之 后 的 快 
速 修复 ， 它 们 的 目的 就 是 持续 地 一 点 儿 一 点 儿 发 现 问题 并 解决 掉 问 题 ， 从 而 避免 一 次 性 地 突 
然 来 了 很 多 的 问题 ， 导 臻 整个 自动 化 在 需要 执行 的 时 候 不 能 顺利 地 执行 。 


及 时 反馈 报告 结果 


最 后 需要 提 到 的 就 是 当 读者 在 埋头 开发 自动 化 脚本 的 时 候 ， 也 要 偶尔 照顾 下 周边 人 的 感 
受 ， 也 需要 让 测试 、 开 发 、 产 品 等 相关 人 员 了 解 并 知道 读者 的 自动 化 测试 进度 及 效果 ， 因 此 
一 个 简洁 明了 的 自动 化 测试 报告 可 以 说 是 必 不 可 少 的， 报告 的 内 容 不 需要 复杂 和 华丽 ， 只 需 
要 把 相关 的 统计 数据 、 错 误 提示 信息 等 收集 起 来 就 可 以 了 ， 最 好 是 能 做 到 可 以 追溯 历史 。 

当然 ， 上 面 提 到 的 这 10 条 总 结 只 是 大 多 数 项 目 会 经 常 遇 到 的 情况 。 除 此 之 外 ， 不 同 的 
项 目 可 能 还 会 有 各 自 的 一 些 特征 ， 需 要 根据 项 目 自身 的 特点 来 规划 和 调整 。 


第 1 章 


Selenium 基础 


CHAPTER 


在 绪论 中 ， 首 先 对 自动 化 测试 的 概念 进行 了 相关 介绍 ， 主 要 是 为 了 帮助 读者 树立 正确 
的 自动 化 测试 观 ， 不 仅 是 为 了 做 自动 化 而 自动 化 。 从 本 章 开 始 就 要 正式 学 习 自动 化 测试 的 
理论 知识 ， 而 本 章 则 主要 介绍 与 Selenium 相关 的 基础 知识 。Selenium 是 Web 自动 化 测试 比 
较 流 行 的 一 个 框架 ， 本 章 从 Selenium 的 历史 、 特 点 、 名 词 、 原 理 及 环境 等 几 个 方面 来 介绍 
Selenium 的 相关 基础 内 容 。 


1.1 Selenium 的 历史 和 分 支 


Selenium 是 Jason Huggins 在 2004 年 发 起 的 项 目 ， 当 时 他 在 ThoughtWorks 公司 开发 内 
部 的 时 间 和 费用 ( Time and Expenses) 系统 ， 该 系统 使 用 了 大 量 的 JavaScript。 虽 然 在 IE 下 
能 够 正常 执行 ,但 是 当 他 们 在 其 他 浏览 器 上 执行 时 就 会 经 常 出 现 bug， 纵 然 这 是 因为 各 浏览 
器 对 于 JavaScript 的 兼容 性 不 一 致 所 导致 的 ， 而 当时 的 测试 工具 并 没有 一 个 能 够 符合 他 们 理 
想 的 要 求 ， 因 此 他 们 开始 自己 尝试 寻找 新 的 方法 。 
最 终 他 们 还 是 把 注意 力 放 到 了 JavaScript 上 ， 因 为 JavaScript 是 可 以 被 所 有 浏览 器 支持 
的 ， 并 且 具 有 了 驱动 浏览 器 行为 的 能 力 ， 所 以 Jason 和 他 所 在 的 团队 有 理由 采用 JavaScript 编 
写 一 种 测试 工具 来 验证 被 测 应 用 的 行为 。 他 们 受到 FIT ( Framework for Integrated Test) 的 启 
发 ,使 用 基于 表格 的 语法 替代 了 原始 的 JavaScript， 这 种 做 法 支持 那些 编程 经 验 有 限 的 人 在 
HTML 文件 中 使 用 关键 字 驱 动 的 方式 来 编写 测试 。 该 工具 最 初 称 为 “ Selenium ”， 后 来 称 为 


令 
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“Selenium Core”， 在 2004 年 基于 Apache 2 授权 发 布 。 

因为 Selenium 过 去 使 用 纯 JavaScript 编写 ， 它 的 最 初 设 计 要 求 开 发 人 员 把 被 测 应 
用 、Selenium Core 和 测试 脚本 都 部 署 到 同一 台 服 务 器 上 以 避免 触犯 浏览 器 的 安全 规则 和 
JavaScript 沙 箱 策略 。 其 应 用 场景 的 结构 如 图 1-1 所 示 。 


Web 应 用 


Web 服 务 器 


图 1-1 第 1 版 Selenium 的 应 用 场景 结构 


这 个 版 本 的 问题 是 ，Selenium Core 和 Test Script 始终 需要 和 被 测试 的 Web Server 同时 放 
在 一 个 服务 器 上 ， 这 在 部 署 上 就 有 局 限 性 ， 测 试 脚本 和 被 测 系统 的 耦合 性 较 大 ， 而 且 对 于 线 
上 环境 也 并 不 总 是 可 以 这 么 做 。 

为 了 解决 这 个 问题 以 及 其 他 问题 ， 他 们 编写 了 HTTP 代理 ， 这 样 所 有 的 HTTP 请 求 都 
会 被 Selenium 截获 。 使 用 代理 可 以 绕 过 “ 同 源 ” 策 略 2 的 许多 限制 ， 从 而 缓解 了 首要 弱点 。 
这 种 设计 使 得 采用 多 种 语言 编写 Selenium 成 为 可 能 : 各 语言 只 需 把 HTTP 请 求 发 送 到 特定 
URL。 而 连接 方法 则 是 按照 Selenium Core 表格 语法 严格 建 模 ， 称 为 “Selenese”。 因 为 操作 
都 是 通过 远程 来 控制 浏览 器 的 ， 所 以 该 工具 称 为 “Selenium Remote Control” 或 者 “Selenium 


RC” 


。 图 


1-2 为 第 2 版 Selenium 的 应 用 场景 结构 。 


从 图 1-2 中 可 以 看 出 ， 被 测 应 用 、Selenium Core、 测 试 脚本 都 不 再 需要 部 署 到 同一 台 机 
器 上 ， 甚 至 可 以 把 它们 分 别 部 署 在 不 同 的 机 器 上 。 并 且 图 中 也 给 出 了 第 2 版 Selenium 的 应 用 


流程 。 


正当 Selenium 处 于 开发 阶段 的 同时 ， 另 一 款 浏 览 器 自动 化 框架 WebDriver 也 正在 
ThoughtWorks 公司 的 酝酿 之 中 。WebDriver 项 目的 初衷 是 把 端 对 端 测试 与 底层 测试 工具 隔离 


开 。 通 常情 况 下 ， 这 种 隔离 手段 通过 适配器 ( Adapter) 模式 完成 。WebDriver 尝试 的 就 是 对 
不 同 的 浏览 器 进行 原生 绑 定 ， 通 过 直接 驱动 浏览 器 底层 API 的 方式 绕 开 了 浏览 器 的 安全 模 
型 ， 代 价 就 是 框架 自身 的 开发 投入 显著 增加 ， 并 且 需 要 根据 浏览 器 的 版 本 更 新 而 更 新 ;而 好 
处 则 是 更 加 稳定 ， 支 持 的 浏览 器 操作 更 多 。 


@ 同 源 策略 : 一 种 约定 ， 它 是 浏览 器 最 核心 也 是 最 基本 的 安全 功能 ， 所 有 浏览 器 都 对 同 源 策略 进行 了 实现 。 
所 谓 同 源 是 指 域名 、 协 议 、 端 口 都 相同 。 
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浏览 器 
被 测试 应 用 (AUT) 


Web 服 务 器 


图 1-2 第 2 版 Selenium 的 应 用 场景 结构 
结合 两 者 的 优势 ， 最 终 在 2009 年 8 月 他 们 的 创建 者 共同 决定 合并 这 两 个 项 目 ， 称 之 
为 Selenium WebDriver， 这 就 是 Selenium 2。 而 最 初 的 Selenium RC 机制 仍然 维持 ， 帮 助 
WebDriver 在 某 些 浏览 器 不 被 支持 的 情况 下 提供 支持 。 
图 1-3 为 本 地 版 的 应 用 场景 ， 因 为 没有 了 Selenium RC， 所 以 应 用 场景 的 流程 就 变 得 相 


对 简单 了 。 


Web 服 务 器 


图 1-3 第 3 版 Selenium 的 应 用 场景 结构 
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1.2 Selenium 的 特点 


相信 大 多 数 人 选择 Selenium 的 原因 都 是 被 它 的 特点 所 吸引 ， 不 论 是 Selenium 1 还 是 
Selenium 2 都 是 如 此 。Selenium 设计 的 初衷 就 是 为 了 测试 不 同 浏览 器 的 兼容 性 ， 所 以 它 天 
生 就 是 支持 多 浏览 器 的 。Selenium 官方 支持 的 浏览 器 有 Firefox、IE、Safari、HtmlUnit、 
Android、iOS 等 ， 而 Opera、Chrome 则 是 由 第 三 方 支持 的 。 

Selenium 的 另 一 大 特点 则 是 支持 多 个 平台 ， 包 括 Windows、Linux、Mac 等 在 内 的 主流 
操作 系统 ， 一 份 代码 可 以 多 平台 执行 。 

同时 ，Selenium 还 支持 多 语言 开发 脚本 ， 官 方 支持 的 语言 有 Java、JavaScript、Python、 
Ruby、C#， 而 非 官方 的 还 支持 PHP、Perl 等 ， 因 此 可 以 尽 可 能 地 选择 自己 所 喜爱 的 语言 来 开 
发 Selenium 的 脚本 。 

此 外 ，Selenium 还 有 一 个 IDE 工具 ， 可 以 帮助 部 分 初学 者 来 熟悉 和 学 习 Selenium 的 脚 
本 使 用 和 开发 。 可 以 看 到 ，Selenium 是 一 个 真正 的 跨 平 台 、 路 浏览 器 ， 并 且 多 语言 支持 的 
Web 自动 化 测试 工具 。 


1.3 Selenium 名 词 说 明 


1.3.1 Selenium RC 


Selenium RC 是 Selenium Remote Controller 的 简写 ， 它 是 Selenium 1 的 重要 组 成 部 
分 ， 主 要 提供 包括 远程 宿主 浏览 器 的 启动 、HTTP 代理 的 配置 、 与 测试 脚本 通信 等 在 内 的 服 
务 。 与 它 一 起 组 成 Selenium 1 的 其 他 重要 组 件 还 有 Selenium Core、Selenium IDE、Selenium 
Grid。 


1.3.2 Selenium Server 


Selenium Server 是 Selenium 2 的 重要 组 成 部 分 ， 其 主要 功能 是 提供 远程 的 与 WebDriver 
进行 通信 的 服务 ; 相当 于 Selenium 1 中 Selenium RC 的 代理 功能 ， 只 是 Selenium Server 不 再 
进行 JavaScript 的 注入 了 。 

Selenium 2 还 包括 Selenium WebDriver、Selenium Grid、Selenium IDE 等 组 件 。 通 常情 
况 下 是 不 需要 用 到 Selenium Server 的 ， 直 接 使 用 Selenium WebDriver 就 可 以 了 ,但 以 下 三 种 
情况 除外 。 

口 需要 在 远程 机 器 的 浏览 器 上 执行 测试 代码 时 。 

口 需要 使 用 Selenium Grid 进行 分 布 式 测试 执行 时 。 
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口 需要 用 到 HtmlUnit 驱动 但 却 没 有 使 用 Java 开发 脚本 时 。 


1.3.3 Selenium WebDriver 


Selenium WebDriver 是 Selenium 2 中 驱动 浏览 器 的 组 件 ， 它 替代 了 Selenium 1 中 
Selenium Core 与 部 分 Selenium RC 的 作用 。 也 就 是 说 ， 在 Selenium 2 中 关于 浏览 器 驱动 的 事 
情 都 是 由 它 来 负责 ， 而 不 再 需要 其 他 组 件 的 配合 。 而 与 Selenium Core 不 同 的 则 是 WebDriver 
不 只 有 一 个 ， 对 于 支持 的 浏览 器 都 会 有 一 个 对 应 的 WebDriver 来 驱动 。 


1.3.4 Selenium Client 


Selenium Client 即 Selenium 各 种 版 本 的 语言 绑 定 。 官 方 支持 的 Client 有 Java、C#、 
Ruby、Python 、JavaScript ( Node)。 通 过 安装 这 些 Client 包 ， 对 应 的 语言 就 可 以 调用 
Selenium WebDriver 来 驱动 真正 的 浏览 器 进行 测试 。 而 本 书 中 主要 讲解 的 则 是 如 何 基于 
Python Client 来 进行 Selenium 自动 化 脚本 的 开发 与 测试 。 


1.3.5 Selenium Grid 


Selenium Grid 是 Selenium 中 专门 负责 分 布 式 执行 测试 代码 的 组 件 ， 主 要 起 到 的 是 一 个 
类 似 Hub 的 作用 。 

首先 ， 它 会 接受 Agent 的 注册 ; 这 个 Agent 就 是 Selenium Server， 即 可 以 提供 测试 能 力 
的 宿主 机 器 。 

之 后 ，Selenium Grid 就 可 以 接受 来 自 Client 端的 调用 ; 这 个 Client 就 是 测试 脚本 ， 即 驱 
动 测试 执行 的 指令 。 

最 后 ，Selenium Grid 根据 Client 端的 调用 指令 来 驱动 Agent 的 行为 ; 它 的 特点 是 可 以 同 
时 支持 多 个 Agent 和 Client， 这 样 就 可 以 同时 有 多 份 测试 脚本 在 多 个 Agent 上 并 行 执行 ， 从 
而 达到 分 布 式 执行 的 效果 。 而 并 行 执行 测试 的 好 处 就 是 提高 了 测试 效率 。 


1.3.6 Selenium IDE 


Selenium IDE 是 Selenium 的 一 个 测试 用 例 开发 工具 ， 以 Firefox 插件 的 形式 存在 。 测 试 
人 员 在 开启 Selenium IDE 后 ， 就 可 以 通过 正常 操作 页 面 的 方式 来 进行 测试 脚本 的 录制 ， 并 且 
可 以 在 完成 录制 操作 之 后 进行 回放 。 

如 果 回 放 场 景 被 正常 执行 ， 可 以 选择 把 录制 场景 转换 为 自己 偏爱 的 编程 语言 的 测试 用 
例 。 例如， 可 以 把 IDE 录制 的 场景 转换 为 Python 脚本 的 形式 ， 这 样 就 可 以 通过 执行 Python 
脚本 来 执行 测试 用 例 。 同 样 ， 也 可 以 转换 成 任意 其 他 支持 的 脚本 语言 ， 例 如 Java、Ruby 等 。 
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1.4 Selenium 基本 原理 


Selenium 1 的 实现 机 制 是 使 用 Selenium RC 作为 代理 ， 通 过 Selenium RC 向 目标 页 面 
注入 JavaScript ( Selenium Core) 的 形式 ， 来 达到 驱动 浏览 器 进行 自动 化 测试 的 效果 。 由 了 
Selenium 1 现在 已 经 很 少 被 使 用 ， 所 以 这 里 只 简要 分 析 下 Selenium 2 的 运行 原理 。 

在 Selenium 2 中 原来 的 Selenium RC 的 角色 被 WebDriver 替代 了 ， 即 不 再 需要 使 用 代 
理 的 形式 注入 Selenium Core 到 目标 页 面 ， 而 是 直接 通过 WebDriver 来 驱动 浏览 器 。 这 里 的 
WebDriver 指 的 是 可 以 驱动 浏览 器 的 程序 或 插件 ， 每 一 种 浏览 器 都 有 一 个 对 应 的 WebDriver， 
需要 在 执行 测试 脚本 之 前 下 载 并 安装 好 对 应 的 WebDriver 才能 正常 驱动 对 应 的 浏览 器 。 

WebDriver 之 所 以 能 直接 驱动 浏览 器 而 不 再 需要 代理 欺骗 ， 是 因为 它们 使 用 了 各 种 方法 
来 实现 对 浏览 器 底层 API 的 调用 ， 从 而 使 得 WebDriver 绕 过 了 同 源 策略 和 JavaScript 沙 箱 的 
限制 。 此 外 ，WebDriver 以 提供 服务 的 形式 并 通过 JSON Wire Protocol ?协议 来 与 测试 脚本 进 
行 通信 。 图 1-4 则 是 Selenium 2 完整 的 通信 结构 。 


n 


Web 服 务 器 


E; 
WebDriver 
JSON Wire Protocol 
Selenium 
Server 
主机 3 服务 器 
2 主机 2 主机 1 


JSON Wire Protocol 
Grid es 全 测试 了 不 ( cf ) 
Ce ) ED 


图 1-4 Selenium 2 通信 结构 


Selenium 1 能 驱动 浏览 器 是 因为 所 有 浏览 器 对 JavaScript 都 是 兼容 的 。 而 WebDriver 驱 
动 不 同 浏览 器 的 原理 已 经 有 所 变化 了 ， 它 是 针对 每 一 种 浏览 器 开发 一 个 对 应 Driver 程序 ， 统 


@ JSON Wire Protocol : 一 种 基于 HTTP 之 上 的 命令 式 URL 规范 ， 客 户 端 可 以 通过 URL 命令 来 与 服务 器 进 
行 通信 。 
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称 为 WebDriver。 

这 个 Driver 可 能 是 exe 文件 ， 例 如 了 E 和 Chrome 的 Driver， 也 可 能 是 一 个 插件 ， 例 如 
Firefox 的 Driver。 如 果 和 希望 Selenium 2 能 在 本 地 机 器 上 执行 ,那么 必须 在 本 机 上 安装 相应 浏 
览 器 的 WebDriver。 图 1-5 为 WebDriver 的 驱动 流程 。 


see@ 


总 Internet Explorer “Chrome 


Firefox 


3 


beow ecod 


图 1-5 WebDriver 驱动 流程 


其 中 ， 每 一 个 Driver 都 是 一 个 Server， 它 们 启动 后 会 监听 一 个 默认 的 端口 并 等 待 测试 脚 
本 发 送 指令 请 求 ， 并 在 接收 到 请 求 之 后 会 根据 指令 进行 相关 的 浏览 器 接口 调用 。 

在 执行 测试 脚本 时 并 不 需要 手动 启动 这 个 Driver 进程 ， 实 际 上 它 会 在 测试 脚本 正式 执行 
测试 步骤 之 前 自动 启动 。 所 以 在 执行 测试 脚本 的 时 候 虽 然 没 有 启动 Driver 进程 ， 但 在 后 台 其 
实 已 经 被 启动 了 ， 可 以 通过 在 执行 测试 脚本 期 间 查看 进程 管理 器 来 验证 它 。 

当然 ， 也 可 以 手动 启动 这 个 Driver 程序 ， 并 使 用 测试 脚本 与 之 进行 通信 ， 来 执行 具体 的 
测试 步 又。 具体 的 使 用 示例 在 后 面 章 节 会 有 介绍 。 


1.S Selenium 环境 搭建 


由 于 Selenium 2 版 本 相 比 于 Selenium 1 版 本 有 了 很 多 方面 的 提升 和 改进 ， 并 且 Selenium 
1 逐渐 开始 不 再 得 到 维护 ， 所 以 本 书后 面 所 讲解 的 关于 Selenium 的 部 分 ， 若非 特殊 说 明 均 指 
Selenium 2 版 本 及 其 相关 套件 。 
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搭建 Selenium 环境 需要 的 基础 安装 包 如 下 ， 在 具体 安装 之 前 最 好 已 经 下 载 好 这 些 软件 包 


的 对 应 版 本 。 
口 Java; 
口 Python; 


口 Selenium Server (Selenium Remote WebDriver, Selenium Grid ); 
口 Selenium WebDriver (如 下 Driver、Chrome Driver); 


口 Selenium Python Client; 
口 Pycharm IDE。 


1.5.1 Windows 环境 搭建 
1. Java 下 载 和 安装 


由 于 Selenium Server 是 使 用 Java 来 开发 的 ， 所 以 如 果 希 望 本 地 脚本 能 够 调用 远程 的 测 
试 机 器 进行 测试 ; 或 者 希望 测试 和 使 用 完整 的 Selenium 2 的 功能 ， 那 么 就 应 该 安装 好 Java 环 


境 。 下 载 和 安装 Java 的 步骤 如 下 。 


步骤 1 打开 网 址 : http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads- 


2133151.html。 


步骤 2 选择 Accept License Agreement 单 选 按钮 ， 如 图 1-6 所 示 。 


Oveview | Downloads | Documentaton || Communty || Technologies |[ Training 


Java SE Development Kit 8 Downloads 
Thank you for downloading this release of the Java™ Piatform, Standard Edition Development Kit 
(JDK™). The JDK is a development environment for buiiding applications, applets, and components 


Using the Java programming language. 


The JDK includes tools useful for developing and testing programs written in the Java programming 
language and running on the Java platiorm. 


See also 


» java Developer Newsletter From your Oracle account select Subscriptions, expand 
Technology, and subscribe to Java. 


» Java Developer Day hands-on workshops (ree) and other events 


。 Java Magazine 
JDK 8u141 checksum 


Java SE Development Kit 8u141 


You must accept the Oracle Binary Code License Agreement for Java SE to download this 


Product/ File 
Linux ARM 32 Hard Float ABI 
Linux ARM 64 Hard Float ABI 
Linux x86 
Linux x86 
Linux x64 
Linux x64 
Mac OSX 
Solaris SPARC 64-bit 
Solaris SPARC 64-bit 
Solans x64 
Solars x64 
Windows x86 
Windows x64 


® Decline License Agreement 
File Size Download 
cBu141-inux-arm32-vfp-hflt tar gz 
Su141-inux-arm64-vip-hfM tar gz 
“Su141-inux-586 pm 


[le 


179.4 MB_ Sidk-Su141-inux-586 targz 
162.11 MB 141-inuxex64 pm 
17692 MB 41-Inux-x64 tar gz 


-Bu141-macosx-x64 dmg 


139.84 MB 41-solaris-sparcvo tarZ 
99.17 MB 41-Solaris-sparcy tar gz 
140.59 MB 41-solans-x64 tarZ 


-Su141-Solaris-x64 tar gz 
-Su141-windows-i586 .exe 
-Bu141-windows-x64 exe 


Java 安装 包 下 载 页 面 
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步骤 3 选择 Windows 操作 系统 的 Java 安装 包 并 下 载 到 本 地 。 

步骤 4 双击 下 载 下 来 的 二 进 制 文件 (这 里 是 Windows 下 的 exe 文件 )。 

步骤 5 单 击 NEXT 按钮 进行 默认 安装 ， 过 程 中 可 以 选择 安装 路 径 。 这 里 安装 路 径 为 
C:\Program Files\Java\jdk1.8.X XX。 

步骤 6 程序 安装 成 功 后 ， 单 击 Close 按钮 关闭 安装 界面 。 

步骤 7 配置 Java 环境 变量 ， 把 安装 目录 下 的 bin 目录 (C:\Program Files\Java\jdk1.8.X_ 
XX\bin) 加 入 到 path 环境 变量 。 

步骤 8 把 安装 目录 下 的 lib 目录 (C:\Program Files\Java\jdk1.8.X_XX\lib) 加 入 到 classpath 
环境 变量 ， 如 果 没 有 classpath 环境 变量 则 新 建 一 个 。 

步骤 9 测试 Java 环境, 进入 cmd 环境 直接 输入 “java -version”， 如 果 能 返回 Java 的 
正确 版 本 号 则 表示 Java 环境 安装 成 功 ， 如 图 1-7 所 示 。 


| Wdom ordend ee i Ea) 


图 1-7 Java 版 本 查看 


2. Python 下 载 和 安装 
本 书 主要 讲解 如 何 使 用 Python 进行 Selenium 脚本 的 开发 ， 所 以 Python 环境 也 是 必须 要 
安装 的 ， 具体 的 步 又 如 下 。 
步骤 1 进入 Python 的 官网 下 载 页 (https://www.python.org/downloads/)。 
步骤 2 选择 最 新 的 2.7.x 的 版 本 进行 下 载 ， 如 图 1-8 所 示 。 
步骤 3 双击 下 载 下 来 的 exe 文件 。 
步骤 4 单 击 Next 按钮 默认 安装 ， 此 处 安装 路 径 为 C:\python27。 
步骤 5 安装 完成 后 关闭 安装 向 导 程 序 。 
步骤 6 配置 Python 环境 变量 ， 把 Python 的 安装 路 径 ( Ci\python27 ) 添加 到 path 环境 
量 。 


步骤 7 ”把 Python 安装 目录 下 的 scripts 目录 (C:\python27\Scripts) 添加 到 path 环境 变量 。 


并 
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常 进 入 Python 解释 器 环境 则 表示 环境 安装 成 功 ， 如 图 1-9 所 示 。 
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Documentation Community 


图 1-8 Python 下 载 页 面 
步骤 8 测试 Python 环境 。 进 入 cmd 环境 直接 输入 “python” 并 按 回 车 键 ， 如 果 可 以 


ER cAwindoweyoyetemazwma eee - python 


一 :日 


图 1-9 Python 命令 行 
步骤 9 使 用 Python 包 管理 器 查看 第 三 方 类 库 。 进 入 cmd 环境 直接 输入 “pip list” 并 


回 车 键 ， 一 切 正常 则 会 回 显 当前 已 安装 的 第 三 方 库 的 列表 ， 如 图 1-10 所 示 。 


1-10 pip list 查看 


注意 ”如果 下 载 的 是 最 新 版 本 的 Python， 则 在 正确 安装 并 配置 好 Python 之 后 ，pip 包 管 
理 器 命令 是 可 以 直接 使 用 的 ; 而 如 果 下 载 的 是 较 低 版 本 的 Python， 则 可 能 需要 自己 额外 安装 
pip 程序 。 本 书 样 例 中 下 载 的 Python 安装 包 就 已 经 默认 附带 了 pip 包 。 
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3. Selenium Server 下 载 和 启动 

Selenium Server 是 Selenium 2 中 重要 的 组 成 部 分 ， 想 要 完整 地 学 习 和 掌握 Selenium 2， 
Selenium Server 包 就 需要 被 下 载 到 本 地 并 配合 使 用 ， 具 体 步 又 如 下 。 

步骤 1 进入 Selenium 官网 的 下 载 页 面 (http:/docs.seleniumhq.org/download/) 或 者 
http://selenium-release.storage.googleapis.com/index.html 下 载 页 面 。 

步骤 2 找到 最 新 且 稳 定 的 Selenium 版 本 ， 下 载 即 可 。 本 教材 选择 的 是 2.53.1 的 版 本 ， 
其 对 应 文件 名 为 selenium-server-standalone-2.53.1.jar。 

步骤 3 启动 Selenium Server。 通 过 cmd 命令 行进 入 到 Selenium Server 的 保存 路 径 ， 运 
行 命令 java-jar <download jar name> 启动 Selenium Server。 本 文中 的 命令 为 java-jar selenium- 
server-standalone-2.53.1.jar， 如 图 1-11 所 示 。 


天 :CAWindows\ystem32\emd exe - java jar selerium-server-standalone-2.53.1jor 


图 1-11 Selenium Server 启动 


注意 由 于 国内 网 络 环境 的 限制 ， 部 分 读者 可 能 无 法 打开 Selenium 的 官网 ， 那 么 这 部 分 
读者 则 可 以 在 www.testqa.cn/download/selenium 网 站 上 找到 对 应 的 安装 包 和 驱动 文件 。 


4. Selenium WebDriver 下 载 与 安装 
Selenium WebDriver 是 针对 每 一 个 浏览 器 的 特定 驱动 程序 。 例 如 ,IE 的 驱动 程序 是 
IEDriverServer.exe，Chrome 浏览 器 的 驱动 程序 则 是 chromedriver.exe。 而 Firefox 的 驱动 程 
序 则 是 一 个 Firefox 的 插件 ， 它 被 直接 集成 到 Selenium Client 的 lib 包 中 ， 无 须 安装 可 直接 使 
用 。 下 载 浏览 器 Driver 的 方式 很 简单 ， 步 又 如 下 。 
步骤 1 进入 页 面 https://chromedriver.storage.googleapis.com/index.html?path=2.24/， 如 
1-12 所 示 。 


[ 洒 
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/DY httpey//chromedrivers x 人 


将 C | a 去 全 | https//chromedriver storage.googleapis.com/index.html?path=2 


Index of /2.24/ 


Name Last modified Size ETag 


炉 Parent Directory 

图 chromedriver linux32zip 2016-09-10 03:26:31 3.01MB aegbidyseflbp19anal369fs006lela4 

图 chromedriver linux64zip 2016-09-09 00:57:14 2.97MB :56vtbecT60ad2c31226btcgEtcla93 

图 dhromedriver mac64zip 2016-09-0901:58:33 438MB alimettec5lt3ttedtntslecealosT 

阳 chromedriver win32.zip 2016-09-09 02:51:02 3.30MB ”1M6cs392EF89145022TdflCbd6lan9 

图 notestxt 2016-09-09 21:10:50 0.00MB sttcttatezsalaoerirelftscE5alg | 


图 1-12 WebDriver 下 载 页 面 


步骤 2 选择 下 载 Windows 版 的 WebDriver。 
步骤 3 解压 zip 包 并 把 exe 程序 存放 到 系统 环境 变量 ， 例 如 ，C:\python27\Scripts 目 
录 下 。 


注意 由 于 浏览 器 的 版 本 和 功能 是 持续 更 新 的 ， 因 此 针对 不 同 的 浏览 器 其 WebDriver 也 
要 选择 对 应 的 版 本 ， 和 否则 可 能 会 出 现 浏览 器 版 本 过 高 而 WebDriver 版 本 过 低 导 致 无 法 正常 运 
行 测试 脚本 。 


本 书 中 使 用 的 下 浏览 器 版 本 为 ]E8， 对 应 使 用 的 下 DriverServerexe 的 版 本 为 2.53.1， 其 
下 载 地 址 为 : http://selenium-release.storage.googleapis.com/2.53/IEDriverServer_ Win32_2.53.1.zip。 
本 书 中 使 用 的 Chrome 浏览 器 的 版 本 为 V53， 对 应 使 用 的 chromedriver.exe 的 版 本 为 
2.24， 其 下 载 地 址 为 : http://chromedriver.storage.googleapis.com/2.24/chromedriver_win32.zip。 


5. Selenium Python Client 下 载 与 安装 

Selenium Python Client 是 Selenium 的 Python 语言 接口 ， 同 时 也 是 开发 Selenium 脚本 的 
基础 类 库 。 可 以 基于 这 个 类 库 来 开发 Python 测试 脚本 并 驱动 Selenium 的 WebDriver 执行 测 
试 工作 。Python Client 的 安装 方式 有 两 种 ， 一 种 是 源码 下 载 和 安装 ， 步 又 如 下 。 

步骤 1 进入 Selenium 官网 的 下 载 页 。 

步骤 2 浏览 Selenium Client 区 域 。 

步骤 3 单 击 Python 对 应 的 Download 链接 进行 下 载 ， 如 图 1-13 所 示 。 

步骤 4 解压 下 载 到 本 地 的 zip 文件 。 

步骤 5 通过 cmd 命令 进入 解压 的 目录 ， 执 行 命令 python setup.py install 来 安装 Python 
的 Selenium 库 。 
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Selenium Client & WebDriver Language Bindings 


In order to create scripts that interact with the Selenium Server (Selenium RC, Selenium Remote 
WebDriver) or create local Selenium WebDriver scripts, you need to make use of language-specific 
client drivers. These languages include both 1.x and 2.x style clients. 


While language bindings for other languages exist, these are the core ones that are supported by the 
main project hosted on google code. 


Language Release Date 

Java 2016-09-01 ”Download Change log Javadoc 
Cs# 2016-09-02 Download Changelog APLdocs 
Ruby 3.0.0,beta3.1 2016-09-03 Change log APLdocs 
Python Selenium 3.0.0.b2 2016-08-03 change log APLdocs 
Javascript (Node) 3.0.0-beta-2 2016-08-07 可 Change log Apl docs 


图 1-13 Python 下 载 页 面 
另 一 种 安装 方式 是 通过 pip 命令 来 进行 安装 ， 直 接 在 cmd 中 执行 命令 : 
>> pip install selenium 
安装 完成 之 后 可 以 通过 pip 命令 查看 Python 安装 包 中 是 否 有 Selenium 包 ， 命 令 为 : 
>> pip list 


可 以 从 输出 的 列表 中 查看 到 本 书 所 使 用 的 Python Selenium 的 版 本 为 2.53.6， 其 对 应 所 驱 
动 的 Firefox 的 版 本 为 45.3， 执 行 效果 如 图 1-14 所 示 。 


1d 1.8.8_161-bi 
1d 25.181-b13 


图 1-14 Python 安装 包 列 表 


注意 ”由 于 WebDriver 和 浏览 器 的 版 本 没有 严格 意义 上 的 同步 ， 而 且 Chrome 和 Firefox 
的 浏览 器 版 本 更 新 非常 快 ， 所 以 有 时 候 会 出 现 本 来 正常 的 脚本 突然 不 能 驱动 浏览 器 的 情况 ; 
一 旦 出 现 这 种 情况 通常 是 浏览 器 被 自动 升级 了 ， 其 解决 方法 有 两 种 : 首选 是 升级 到 最 新 的 
WebDriver， 其 次 是 降低 浏览 器 版 本 。 
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6. PyCharm 下 载 与 安装 

PyCharm 是 Python 的 一 个 开源 IDE， 在 进行 Selenium 脚本 开发 的 时 候 ， 可 以 选择 熟悉 
的 IDE 作为 开发 工具 ， 本 书 中 推荐 的 是 PyCharm， 其 安装 步 又 如 下 。 

步骤 1 进入 PyCharm 下 载 页 http://www.jetbrains.com/pycharm/download/。 

步骤 2 选择 Windows 的 社区 版 本 进行 下 载 ， 如 图 1-15 所 示 。 


Download PyCharm 


i 


Professional Community 
Full-featured IDE Lightweight IDE 

for Python & Web for Python & Scientific 
development development 


Pa ED 


图 1-15 PyCharm 下 载 页 面 


步骤 3 ”双击 下 载 的 exe 程序 并 进行 默认 安装 。 
步骤 4 完成 安装 后 双击 桌面 上 的 PyCharm 快捷 方式 启动 IDE。 


1.5.2 ”Ubuntu 环境 搭建 


Ubuntu 环境 下 安装 Selenium 环境 的 步骤 与 Windows 基本 是 一 样 的 。 唯 一 有 区 别 的 是 
Ubuntu 下 默认 会 安装 好 Python 程序 ， 但 是 Python 的 包 管理 工具 还 是 需要 自己 安装 的 。 


1. Java 下 载 和 安装 

Unbuntu 下 Java 的 下 载 和 安装 步骤 如 下 。 

步骤 1 进入 网 址 http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads- 
2133151.html。 

步骤 2 选择 Accept License Agreement 单 选 按钮 。 

步骤 3 下 载 Linux 版 本 的 Java 安装 包 (注意 操作 系统 位 数 )， 如 图 1-16 所 示 。 

步骤 4 解压 到 指定 目录 ， 如 /usr/jdk1.8.0。 

步骤 5 打开 /etc/profile 文件 ， 追 加 如 下 信息 到 文件 尾部 。 


export JAVA HOME=/usr/jdk1.8.0 

export JRE HOME=$JAVA HOME/jre 

export CLASSPATH=.:$CLASSPATH:$JAVA HOME/1ib:$JRE HOME/1ib 
export PATH=$PATH:$JAVA HOME/bin:$JRE HOME/bin 
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Oveview | Downloads | Documentation | Community || Technologies || Training 


Java SE Development Kit 8 Downloads 

Thank you for downloading this release of the Java™ Platform, Standard Edition Development Kit 
(JDK™). The JDK is a development environment for building applications, applets, and components 
using the Java programming language 


The JDK includes tools useful for developing and testing programs written in the Java programming 
language and running on the Java platiorm 
See also 


» Java Developer Newsletier From your Oracle account, select Subscriptions, expand 
Technology. and subscribe to Java. 


weioper Day hands-on workshops (ree) and other events 


Java SE Development Kit 8u141 
You must accept the Oracle Binary Code License Agreement for Java SE to download this 


Software. 
Thank you for accepting the Oracle Binary Code License Agreement for Java SE; you may 
now downioad this software. 


Product / File Description File Size 
Linux ARM 32 Hard Float ABI 77.88 MB 各 
Linux ARM 64 Hard Float ABI 74.83 MB 
Linux x86 164.66 MB 
Linux x36 179.4 MB 
Linux x64 162.11 MB 
Linux x64 176.92 MB 
Mac OSX 226.6 MB 
Solans SPARC 64-bit 139.84 MB 
Solaris SPARC 64-bit 99.17 MB 


Solans x64 140.59 MB 
Solaris x64 97.01 MB 
Windows x86 190.95 MB 
Windows x64 19778 MB 一 


图 1-16 Java 下 载 页 面 


步骤 6 执行 source /etc/profile 命令 使 设置 生效 。 
步骤 7 终端 输入 java-version 命令 查看 是 否 安装 成 功 ， 如 图 1-17 所 示 。 


macy@macy-VirtualBox:/usr/jdk1.8.0 


macy -Vir tualBo $ java -ve 
on["1.8.0_141 
E KUTEUWE ETIVTronment (build 1.8.6_141-bl5) 
spot(TM) 64-Bit Server VM (build 25.141-b15，mtxed mode) 
VirtualB /jdk1.8.0$ 


图 1-17 Ubuntu 下 Java 版 本 查看 


2. Python pip 命令 安装 

Ubuntu 下 不 需要 安装 Python， 但 是 需要 安装 pip 命令 环境 ， 具体 的 步骤 如 下 。 
步骤 1 终端 输入 命令 sudo apt install python-pip。 

步骤 2 输入 “Y” 确 认 安装 。 

步骤 3 输入 pip list 并 按 回 车 键 查看 已 有 Python 安装 包 ， 如 图 1-18 所 示 。 


K< 
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macy@macy-VirtualBox: ~ 
gox:~$| ptp list 


图 1-18 Ubuntu 下 pip 安装 包 查 看 


3. Selenium Server 下 载 和 启动 

Selenium Server 包 下 载 与 Windows 一 样 ， 具 体 步 骤 如 下 。 

步骤 1 进入 Selenium 官 网 的 下 载 页 面 (http://docs.seleniumhq.org/download/) 或 者 
http://selenium-release.storage.googleapis.com/index.html 下 载 页 面 。 

步骤 2 找到 最 新 且 稳 定 的 Selenium 版 本 ， 下 载 即 可 。 本 教材 选择 的 是 2.53.1 的 版 本 ， 
其 对 应 文件 名 为 selenium-server-standalone-2.53.1.jar。 

步骤 3 终端 进入 Selenium Server 的 JAR 包 保 存 路 径 。 

步骤 4 运行 命令 java-jar <download jar name> 启动 Selenium Server。 本 文中 的 命令 为 
java-jar selenium-server-standalone-2.53.1.jar， 如 图 1-19 所 示 。 


macy@macy-VirtualBox:~/ 桌 面 
irtualBox:~/ 桌 面 $ java -jar selenium-server-standalone-2.5 


INFO - Launching a standalone Selenium Server 
INFO - Oracte Corporatton 25.141-bl5 

INFO - Linux 4.16.9-28-genertc and64 

INFO - v2.53.1, with Core v2.53.1. Built from revision a 


INFO - Driver provider org.openqa niun. ie.InternetEx 
plorerDriver registration ts skt 
stratton capabilities Capabili recleansession=true, bro 
tnternet explorer, ver > NINDONS}] does not mat 
the current platform LINUX 
INFO - Drtver provider org.openqa.selenium.edge.EdgeDriv 
sk : 


Capabilities [{browserNane=MicrosoftEdge, v 
platform=WINDONS}] does not match the current platform LINUX 
7.249 INFO - Driver class not found: com.opera.core.systems.0p 


- Driver provider com.opera.core.systens.0peraDrive 


r provider org.openqa.selenium.safari.safari 
river regi i 
istratio abi Capabilities [{browserNam 
not match the current platform LIN 
not found: org.openqa.selenium.htnlu 


7.252 INFO - Driver provider org.openqa.setentum.htmtuntt.HtmL 
not registered 
2 INFO - RemoteWebDriver instances should connect to; http 
4444/wd/hub 
- Seleniun Server ts up and running 


图 1-19 Ubuntu 下 启动 Selenium Server 
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4. Selenium WebDriver 下 载 与 安装 
Ubuntu 下 目前 只 支持 Chrome 和 Firefox， 所 以 只 需 下 载 Chrome 的 WebDriver。 步 又 


如 下 。 


步骤 1 访问 Chrome WebDriver 下 载 地 址 https://chromedriver.storage.googleapis.com/ 


index.html?path=2.24/。 


步骤 2 ”下载 对 应 的 Linux 版 WebDriver， 例 如 ，chromedriver linux64.zip。 
步骤 3 解压 zip 包 , 并 把 bin 放 到 系统 环境 变量 ， 例 如 ，/usrlocal/bin 目录 下 。 


5. Selenium Python Client 下 载 与 安装 
Ubuntu 下 可 以 通过 pip 命令 直接 安装 Selenium Python Client: 


>> pip install selenium 


安装 完成 之 后 可 以 查看 是 否 安装 成 功 ， 如 图 1-20 所 示 。 


图 1-20 Selenium 安装 包 查看 


6. PyCharm 下 载 与 安装 
Ubuntu 下 PyCharm 的 安装 步 又 如 下 。 
步骤 1 进入 PyCharm 的 下 载 页 http://www.jetbrains.com/pycharm/download/。 


步骤 2 选择 Linux 的 社区 版 本 进行 下 载 ， 如 Download PyCharm 


图 1-21 所 示 。 . | 
步骤 3 使 用 tar a pye botnetar es romaaiornal Comminity 
pycharm 命令 解压 到 指定 目录 ， 如 /usr/pycharm。 Full-teatured IDE Lightweight IDE 
ror Python & Web to? Python & Scientific 
步骤 4 终端 进入 到 bin 子 目录 。 vert development 
步骤 5 执行 ./pycharm.sh 命令 启动 IDE， 如 ED bE 


图 1-22 所 示 。 


图 1-21 Linux 版 本 PyCharm 下 载 页 面 
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File Edit Vien Nevigste Dode Refactor Ra Tools VOB Window Help 


untitled ) 关 denc-py) dem 
国 Pajet > 加 韦 | 交 "二 | 也 dere.ny 
| untitled -Frihanprli print "hello world™ 

莫 demo.F7 


上 MhExtersal Librariss 


加 于 dm 妆 " 土 | 

pl» /usr/bin/python2.7 /home/macy/PycharnProjects/untitled/demo.py 
hello world 

m+ 

| Process finished with exit code 9 

图 


图 1-22 PyCharm 界面 


1.5.3 ”MacOS 环境 搭建 
MacOS 环境 下 搭建 Selenium 环境 的 步骤 与 Ubuntu 下 基本 一 致 。 


1. Java 下 载 和 安装 

步骤 1 打开 http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads- 
2133151.html。 

步骤 2 选择 Accept License Agreement 单 选 按钮 。 

步骤 3 下 载 MacOS 版 本 的 Java 安装 包 ， 如 图 1-23 所 示 。 


[Guevew | pownioads | Documentaton || Communiy | Technooges || Traning | 


Java SE Development Kit 8 Downloads 

Thank you for downloadng this reiease cf the Java™ Plasorm, Standard Editon Development Ki 
(DK™) The JDK isa davelopment environment for buildng applications, applets and compenerts 
vsing the Java prooramming lan0ua0e， 


The JOK includes tools useul for developing and testing programs writen in he Java programming 
language and running on the Java platfomm. 


Seealso 


» Jara Developer Newsletter. From your Dracle actount select Subscriptons, expana 
Tochnology. and subecribe to Java 


» Java Developer Day nands-on worksnops Imes) and otner events 
» Jaya Magazne 
JDK aut41 checksum 


Java SE Development Kit 8u141 
You must accept the Oracle RE SE to download this 


Thank you for accepting the Oracle Binary Code License Agreement for Java SE; you may 
now 


download this software. 
Product | File Description File Size Download 

Unux ARM 32 Hard Float ABI 77.88 MB Sjdk-8u141-int-arm32.vip-ht tar gz 

Lintx ARM 64 Hard Float ABI 74.83 MB Sjdk-8u141-inux-arm64-vip-hft tar gz 

Linwx x36 164.66 MB $jdk-86141-inux-586.rpm 

Linwx xa6 173.4 MB #jdk-Su141-inu1586 .ar gz 

Linux x64 162 11 MB Sjdk-Bu141-nuxx64.rpm 

Unuxx84 17692MB 

Mac OSX 225 6 MB 

Solaris SPARC 64-Dt T3984ME 

Solaris SPARC 64-bt 9917MB 六 

Solansx64 14059 MB 

Solansx64 97.01 MB §jdk-8u141-Solars -64 1ar gz 

Windows x36 190.95 MB $jdk-8u141-windows-i536.exe 

Windows 64 19778 ME Sjdk-Su141-windows-xé4.@xe 


图 1-23 Mac OS 版 本 Java 下 载 页 面 
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步骤 4 单 击 dmg 安装 包 进 行 默 认 安装 。 
步骤 5 使 用 /usr/libexec/java_home 命令 查看 JAVA_HOME 目录 位 置 ， 如 图 1-24 所 示 。 


$ /usr/ libexec/java_ home -Y 
Ee Java Virtual Jechines 人: 
下 3 


图 1-24 Mac OS 查看 JAVA_HOME 路 径 


步骤 6 编辑 /etc/profile 文件 ,配置 JAVA_HOME 及 PATH 信息 。 


JAVA_HOME="/Library/Java/JavaVirtualMachines/jdk1.8.0_121.jdk/Contents/Home" 
CLASS_PATH="$JAVA_ HOME/1ib" 
PATH=". : $PATH: $JAVA_HOME/bin" 


步骤 7 执行 source /etc/profile 命令 使 修改 生效 。 
步骤 8 终端 执行 命令 echo SJAVA_HOME 查看 是 否 成 功 。 


$ echo $JAVA HOME 
/Library/Java/JavaVirtualMachines/jdk1.8.0_121.jdk/Contents/Home 


2. Python pip 命令 安装 
Mac 中 也 不 需要 安装 Python， 直 接 安装 pip 命令 即 可 。 具 体 命令 如 下 。 


sudo easy install pip 


3. Selenium Server 下 载 和 启动 

Mac 下 Selenium Server 的 下 载 步 又 如 下 。 

步骤 1 进入 Selenium 官 网 的 下 载 页 面 (http://docs.seleniumhq.org/download/) 或 者 
http://selenium-release.storage.googleapis.com/index.html 下 载 页 面 。 

步骤 2 找到 最 新 且 稳定 的 Selenium 版 本 ， 下 载 即 可 。 本 教材 选择 的 是 2.53.1 版 本 ， 其 
对 应 文件 名 为 selenium-server-standalone-2.53.1.jar。 

步骤 3 启动 Selenium Server。cmd 命令 行进 入 到 Selenium Server 的 保存 路 径 ， 运 行 
命令 java-jar <download jar name> 启动 Selenium Server (本 文中 的 命令 为 java-jar selenium- 


server-standalone-2.53.1.jar)。 


4. Selenium WebDriver 下 载 与 安装 

Mac 下 官方 支持 的 只 有 Chrome WebDriver， 具 体 下 载 步骤 如 下 。 

步骤 1 进入 下 载 页面 https://chromedriver.storage.googleapis.com/index.html?path=2.24/。 
步骤 2 选择 Mac 版 本 的 WebDriver 并 下 载 到 本 地 。 

步骤 3 解压 zip 包 并 把 二 进 制 文件 存放 到 系统 变量 目录 ,例如 ，/usr/local/bin。 


28 及 Python Web 自动 化 测试 设计 与 实现 


5. Selenium Python Client 下 载 与 安装 

Mac 下 安装 Selenium Python Client 的 命令 如 下 。 

>> pip install selenium 

安装 完成 之 后 通过 pip list 命令 查看 是 否 安装 成 功 。 

6. PyCharm 下 载 与 安装 

Mac 下 PyCharm 的 下 载 与 安装 步 又 如 下 。 

步骤 1 进入 PyCharm 的 下 载 页 http://www.jetbrains.com/pycharm/download/。 
步骤 2 选择 Mac 的 社区 版 本 进行 下 载 ， 如 图 1-25 所 示 。 


Download PyCharm 


Professional Community 
Full-featured IDE Lightweight IDE 

for Python & Web for Python & Scientific 
development development 


te EE 
Frea tnal 


res open 


图 1-25 Mac OS 版 本 PyCharm 下 载 页 面 
步骤 3 双击 下 载 的 安装 包 进 行 默 认 安 装 。 
步骤 4 安装 完成 后 在 application 中 查找 PyCharm 程序 并 运行 。 


1.6 _ Selenium 调用 不 同 浏览 器 


1.5 节 介 绍 了 Selenium 的 安装 流程 ， 本 节 开 始 学 习 使 用 Python 来 开发 Selenium 脚本 调 
用 不 同 的 浏览 器 ， 确 保 搭 建 的 自动 化 环境 能 联 调 成 功 ， 为 后 面 正式 的 脚本 学 习 做 好 准备 。 


1.6.1 调用 Firefox 浏览 器 

为 了 后 面 代码 开发 和 执行 的 规范 和 一 致 性 ， 这 里 介绍 如 何在 PyCharm 中 创建 和 执行 
Python 文件 ， 后 面 内 容 如 没有 特殊 说 明 则 以 此 流程 为 标准 。 具 体 流程 如 下 。 

步骤 1 打开 PyCharm 程序 。 

步骤 2 单 击 Create New Project。 

步骤 3 选择 一 个 项 目 路 径 ， 单 击 Create。 
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步骤 4 右 击 项 目 New 一 Python File 一 输入 文件 名 如 “ 任 ” 一 单 击 OK。 

步骤 5 在 新 建 的 文件 内 输入 具体 的 测试 代码 。 

步骤 6 在 文件 内 区 域 右 击 ， 选 择 Run“ 企 ”执行 Python 文件 。 

步骤 7 查看 运行 结果 是 否 与 脚本 场景 所 一 致 ， 如 果 一 致 则 表示 demo 脚本 运行 成 功 。 

在 调用 Firefox 浏览 器 时 ， 关 键 在 于 启动 Firefox 的 WebDriver 示例 ， 关 键 代码 如 下 。 

driver = webdriver.Firefox() 

而 除了 能 正常 启动 Firefox 浏览 器 之 外 ， 还 需要 测试 下 能 否 正常 驱动 浏览 器 的 行为 。 为 
此 ， 通 过 一 小 段 测试 代码 来 测试 浏览 器 的 调用 行为 。 具 体内 容 如 下 。 


oding:nbf-0: = 


于 


from selenium import webdriver 

u''' 打开 百度 首页 ， 输入 Selenium 进行 搜索 ''' 

driver = webdriver.Firefox() 

driver.get ("http://www.baidu.com") 

assert (u" 百度 " in driver.title) 

driver .find element by _ id("kw").send keys ("selenium") 
driver .find element by id("su").click() 

assert (u"selenium 百度 搜索 "in driver.title) 
driver.close () 


driver.quit () 


这 段 代 码 所 要 执行 的 测试 场景 依次 如 下 。 

(1 ) 启动 Firefox 的 WebDriver 实例 。 

(2 ) 浏览 http:/www.baidu.com 网 址 。 

(3 ) 检查 浏览 器 标题 中 是 否 包 含 “ 百 度 ” 字 样 。 

(4 ) 查找 搜索 输入 框 (id=kw 的 元 素 ) 并 输入 “selenium ”字符 串 。 
(5 ) 查找 搜索 按钮 (id=su 的 元 素 ) 并 执行 “ 单 击 ” 操 作 。 

(6 ) 检查 浏览 器 标题 中 是 否 包 含 “selenium_ 百 度 搜 索 ” 字 样 。 
(7) 关闭 浏览 器 窗口 。 

(8 ) 关闭 WebDriver 实例 。 


1.6.2 ”调用 Chrome 浏览 器 


同样 的 测试 场景 再 来 测试 下 Chrome 的 调用 行为 。 这 里 需要 把 原本 启动 Firefox 的 代码 替 
换 为 启动 Chrome 的 代码 。 替 换 的 内 容 如 下 。 


driver = webdriver.Chrome () 


另外 新 建 一 个 chrome.py 的 文件 ， 并 输入 完成 的 测试 场景 代码 ， 具 体 如 下 。 
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# “~ coding:utf~0 一 一 

from selenium import webdriver 

u'"'" 打开 百度 首页 ， 输 入 Selenium 进行 搜索 '' 

driver = webdriver.Chrome () ## 修改 的 内 容 
driver.get ("http://www.baidu.com") 

assert (u" 百度 " in driver.title) 

driver.find element by id("kw").send keys ("selenium") 
driver .find element by id("su") .click() 

assert (u"selenium 百度 搜索 " in driver.title) 
driver.close() 

driver.quit () 


完成 代码 输入 之 后 ， 在 文件 空白 处 右 击 并 选择 Run“ chrome ”执行 Python 文件 。 观 察 实 


际 的 运行 结果 与 脚本 场景 是 否 一 致 。 


1.6.3 调用 IE 浏览 器 


最 后 试 一 下 IE 浏览 器 的 调用 行为 。 同 样 需要 把 启动 浏览 器 的 代码 替换 掉 。 这 里 需要 蔡 


换 为 启动 下 浏览 器 的 代码 。 关 键 代码 为 : 


driver = webdriver.Ie() 
另外 新 建 一 个 ie.py 文件 并 输入 完整 的 测试 场景 代码 ， 全 部 代码 如 下 所 示 。 


4 podingeutf-B 二 “一 

from selenium import webdriver 

u' '' 打开 百度 首页 ， 输入 Selenium 进行 搜索 ''' 
driver = webdriver.Ie() 

driver.get ("http://www.baidu.com") 

assert (u" 百度 " in driver.title) 

Adriver .find element_by_id("kw") .send keys ("selenium") 
driver .find element_by_id("su") .click() 
assert (u"selenium 百度 搜索 "in driver.title) 
driver.close () 

driver.quit () 


完成 文件 内 容 输入 之 后 ， 在 文件 空白 处 右 击 并 选择 Run“ie” 执 行 该 Python 文件 。 同 样 


需要 检查 浏览 器 的 行为 与 测试 场景 是 否 一 致 。 


1.6.4 IE 浏览 器 安全 机 制 设置 


需要 注意 的 是 由 于 下 的 安全 机 制 策略 ， 可 能 会 导致 启动 浏览 器 异常 。 这 里 需要 对 下 浏 


览 器 进行 预 设置 ， 即 关闭 下 的 “启用 保护 模式 ”。 


具体 设置 方法 为 : 打开 正 浏 览 器 一 选择 “设置 ”菜单 一 打开 “ Internet 选项 ”对 话 框 


一 切换 到 “安全 ”选项 卡 一 依次 单 击 Internet、“ 本 地 Intranet”“ 受 信任 的 站 点 ”“ 受 限制 的 站 


点 ” 


一 取消 所 有 “启用 保护 模式 ”的 选中 状态 一 保存 设置 ， 如 图 1-26 所 示 。 
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如 果 被 测试 页 面 中 包含 fame， 并 且 子 frame 
与 父 frame 不 是 同 源 的 情况 下 ， 使 用 Selenium 操作 
子 frame 的 时 候 ， 则 需要 进行 “受信 站 点 ”设置 。 
具体 设置 步骤 如 下 。 

(1) 打开 下 浏览 器 的 “Internet 选项” 对话 框 
并 切换 到 “安全 ”选项 卡 。 


常规 | 支 全 ”| 隐私 [内 容 | 连接 [程序 | 高 级 
选择 一 个 区 域 以 查看 或 更 改 安全 设置 


@®@ VO i 
ba 受信 全 的 站 到 s 


Internet 


@ 蝴 旺 时 


站 点 @) 


(2 ) 单 击 “ 受 信任 的 站 点 ”图 标 ， 如 图 127 | 
所 示 。 a 


(3 ) 单 击 “站 点 ”按钮 ， 并 在 弹出 框 中 输入 子 
frame 的 url 域名 ， 如 图 1-28 所 示 。 

(4 ) 单 击 “添加 ”按钮 并 保存 设置 。 

通常 经 过 上 述 两 项 设置 之 后 , IE 浏览 器 都 可 
以 正常 地 被 Selenium 调用 。 如 果 设 置 之 后 启动 下 浏览 器 仍 有 问题 ， 则 可 能 是 WebDriver 版 
本 与 当前 下 浏览 器 的 版 本 不 一 致 。 另 外 ， 在 学 习 过 程 中 如 果 有 遇 到 其 他 问题 ， 还 可 以 到 
http://www.testqa.cn 上 的 Selenium 小 组 中 进行 提问 。 


固 启用 保护 模式 要 求 
Internet Expler， 


可 了 


自 定义 级 别 C).， ] [ 默认 级 别 @) 
将 所 有 区 域 重 置 为 默认 级 别 @) 


图 1-26 IE 取消 启用 保护 模式 设置 


internet sm h | 
常 坑 | 安全 。 | 隐私 | 内容 | 连接 | 程序 | 高 级 
选择 一 个 区 域 以 查看 或 更 小 安全 设 


@ 包 S 月 
Internet 本地， .| Bl 外 | 


术 企 的 站 点 要 码 
tn 


该 区 域 中 有 网 站 。 
该 区 域 的 安全 级 别 @) 


自 定义 _ 
2 | 


-ian Em 
| 将 所 有 区 域 重 置 为 默认 级 别 EB) 


CC 到 CW |] (BR 


页 


图 1-27 IE 信任 站 点 设置 1-28 IE 信任 站 点 添加 


1.7 Selenium Docker 的 使 用 
Docker 是 一 个 开源 的 应 用 容器 引擎 ， 也 是 近年 来 比较 热门 的 虚拟 化 技术 。 它 让 开发 者 可 
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以 打包 他 们 的 应 用 以 及 依赖 包 到 一 个 可 移植 的 容器 中 ， 然 后 发 布 到 任何 流行 的 Linux 机 器 上 ， 
也 可 以 实现 虚拟 化 。 容 器 是 完全 使 用 沙 箱 机 制 ， 相 互 之 间 不 会 有 任何 接口 。 

Docker 之 所 以 被 人 们 热 捧 和 关注 ， 主 要 是 因为 它 轻 量 级 虚拟 化 和 可 移植 的 特性 。 环 境 搭 
建 这 类 工作 是 Docker 技术 天 然 支持 的 使 用 场景 。 它 可 以 很 快 地 复制 并 启动 一 个 完全 一 样 的 
环境 ， 并且 关闭 容器 后 会 自动 恢复 到 启动 时 的 环境 。 

Docker 技术 目前 在 各 个 行业 都 有 很 多 的 人 在 尝试 和 实践 ， 很 幸运 的 是 Selenium 也 
是 Docker 的 实践 者 之 一 。 本 章 主 要 介绍 如 何 搭建 Docker 环境 ， 并 在 Docker 容器 中 运行 
Selenium 脚本 。 


1.7.1 ”Docker 环境 安装 


目前 Docker 可 以 在 很 多 的 平台 下 进行 安装 ， 包 括 Linux、MacOS、Windows、AWS、 
Azure。 这 里 只 针对 Ubuntu、MacOS 和 Windows 环境 搭建 进行 介绍 。 


1. Ubuntu 安装 Docker 

Ubuntu 下 可 以 安装 的 Docker 有 两 个 版 本 : Docker CE( 社 区 版 ) 和 Docker EE( 企 业 版 本 )。 
这 里 选择 Docker CE 版 本 。 另 外 ，Docker 只 支持 64 位 的 Ubuntu， 且 仅 支 持 如 下 版 本 。 

口 Zesty 17.04 (LTS); 

口 Yakkety 16.10; 

口 Xenial 16.04 (LTS ); 

口 Trusty 14.04 (LTS )。 

具体 的 Docker 安装 步骤 如 下 。 

(1 ) 访问 Docker 下 载 页 面 https://download.docker.com/linux/ubuntu/dists/。 

(2 ) 选择 对 应 的 Ubuntu 版 本 ， 如 zesty。 

(3 ) 进入 到 pool/stable/ 路 径 下 。 

(4 ) 选择 对 应 的 CPU 架构 ， 如 amd64。 

(5 ) 下 载 .deb 文件 。 

(6 ) 执行 sudo dpkg -i /path/to/package.deb 命令 安装 Docker。 

(7 ) 执行 sudo docker run hello-world 命令 。 

(8 ) 出 现 如 下 界面 则 表示 Docker 安装 成 功 ， 如 图 1-29 所 示 。 


2. Windows 安装 Docker 

在 Windows 下 要 运行 Docker 也 是 需要 条 件 的 ， 具 体 如 下 。 
口 64 位 的 Windows。 

口 仅 支 持 Windows10 的 企业 版 和 教育 版 。 
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口 支持 Microsoft Hyper-V。 


un an Ubuntu container with: 


图 1-29 ”Ubuntu 下 启动 Docker 成 功 界面 


在 Windows 下 安装 Docker CE 的 具体 步骤 如 下 。 

(1 ) 下 载 Docker 安装 包 https://download.docker.com/win/stable/InstallDocker.msi。 
(2 ) 双击 InstallDockermsi 安装 文件 。 

(3 ) 依次 确认 安装 向 导 中 的 许可 、 授 权 等 操作 。 

(4 ) 完成 安装 并 启动 Docker。 

(5 ) 启动 一 个 命令 行 ， 输入 docker run hello-world 命令 。 

(6) 出 现 如 下 界面 则 表示 安装 成 功 ， 如 图 1-30 所 示 。 


到 1-30 ”Windows 下 启动 Docker 成 功 界面 


3. Mac OS 安装 Docker 
在 Mac OS 下 安装 Docker CE 具体 的 系统 需求 如 下 。 
口 2010 年 之 后 发 行 的 Mac。 
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口 硬件 支持 Intel 的 MMU 虚拟 化 技术 。 

口 OS X 的 版 本 为 El Capitan 10.11 或 更 高 。 

口 最 少 4GB 内 存 。 

口 不 能 安装 4.3.30 之 前 版 本 的 VirtualBox。 
具体 的 安装 步骤 如 下 。 

(1 ) 下 载 安装 包 https://download.docker.com/mac/stable/Docker.dmg。 
(2 ) 双击 安装 包 。 

(3 ) 把 鲸鱼 图 标 拖 放 到 Applications 目录 。 

(4 ) 双击 Applications 目录 中 的 Dockerapp。 

(5 ) 为 安装 向 导 进 行 授权 并 完成 安装 。 

(6) 检查 鲸鱼 图 标 是 否 在 头 部 状态 栏 出 现 。 

(7 ) 打开 一 个 终端 运行 docker run hello-world 命令 。 
(8 ) 出 现 如 下 界面 表示 安装 成 功 ， 如 图 1-31 所 示 。 


图 1-31 Mac OS 下 启动 Docker 成 功 界面 


4. Docker Toolbox 

如 果 系 统 是 Windows 或 Mac， 但 硬件 配置 却 没有 满足 要 求 ， 还 可 以 通过 Docker Toolbox 
来 安装 Docker 环境 。Docker Toolbox 是 一 组 Docker 工具 的 集合 ， 是 专门 为 那些 硬件 条 件 不 
够 的 老 系统 搭建 Docker 环境 而 提供 的 一 个 折 中 方案 。 

Docker Toolbox 安装 包 主 要 包括 : docker、docker-compose、docker-machine、Docker 
GUI 和 virtualBox。 

Docker for Windows、Docker for Mac 都 是 直接 运行 在 硬件 的 虚拟 化 技术 之 上 。 而 Docker 
Toolbox 则 是 让 Docker 运行 在 一 个 Linux 的 VM 之 上 ， 每 次 运行 Docker 之 前 都 会 先 运 行 该 
VM， 然 后 在 这 个 虚拟 机 之 上 运行 Docker 容器 。 
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在 Windows 下 安装 Docker Toolbox 可 以 参考 页 面 : https://docs.docker.com/toolbox/toolbox_ 
install windows/。 
在 Mac 下 安装 Docker Toolbox 可 以 参考 页 面 : https://docs.docker.com/toolbox/toolbox_install_ 


mac/。 


1.7.2 Selenium Docker 镜像 下 载 


在 完成 Docker 环境 的 搭建 之 后 ， 想 要 运行 Docker 还 需要 下 载 对 应 的 Docker 镜像。 
Docker 镜像 在 Docker 上 运行 之 后 ， 就 会 生成 一 个 Docker 容器 ， 这 个 容器 就 是 可 以 提供 独立 
服务 的 载体 。 

Selenium Docker 项 目 有 多 个 镜像 文件 ， 进 入 到 它 的 Github 项 目 页 面 ， 就 可 以 看 到 这 些 
具体 的 Docker 镜像 。 访 问 https://github.com/SeleniumHQ/docker-selenium， 其 包含 的 镜像 文 
件 及 说 明 如 下 。 

口 selenium/base: 包含 Java 运行 时 环境 和 Selenium JAR 包 ， 其 他 镜像 的 基础 镜像 。 

口 selenium/hub: Selenium Grid Hub 镜像 。 

口 selenium/node-base : 所 有 Selenium Grid Node 的 基础 镜像 ， 包 含 一 个 虚拟 的 桌面 环境 

和 VNC 服务 。 

口 selenium/node-chrome: Chrome 类 型 的 Selenium node， 用 于 连接 Grid Hub。 

口 selenium/node-firefox: Firefox 类 型 的 Selenium node， 用 于 连接 Grid Hub。 

口 selenium/node-phantomjs: PhantomJS 类 型 的 Selenium node， 用 于 连接 Grid Hub。 

口 selenium/standalone-chrome: 独立 的 Selenium Chrome 测试 环境 。 

口 selenium/standalone-firefox: 独立 的 Selenium Firefox 测试 环境 。 

口 selenium/standalone-chrome-debug: 独立 的 带 调试 功能 的 Selenium Chrome 测试 环境 。 

口 selenium/standalone-firefox-debug: 独立 的 带 调试 功能 的 Selenium Firefox 测试 环境 。 

口 selenium/node-chrome-debug: 带 调试 功能 的 Chrome 类 型 的 Selenium node。 

口 selenium/node-firefox-debug: 带 调 试 功能 的 Firefox 类 型 的 Selenium node。 

从 这 个 列表 中 可 以 知道 ，Selenium Docker 项 目 不 仅 提供 了 Selenium Server 的 Docker 服 
务 ; 还 提供 了 Selenium Grid 的 Docker 服务 。 其 可 以 支持 的 浏览 器 包括 Chrome、Firefox、 
PhantomJS ， 其 中 ，PhantomJS 不 支持 独立 的 版 本 。 只 有 Chrome 和 Firefox 支持 带 Debug 的 
版 本 ， 该 版 本 可 以 查看 测试 过 程 中 的 实际 页 面 运行 效果 。 

了 解 了 Selenium Docker 提供 的 服务 之 后 ， 就 可 以 根据 自己 的 需求 来 下 载 对 应 的 镜像 。 
这 里 介绍 下 如 何 下 载 一 个 镜像 文件 。 具 体 步 又 如 下 。 

步骤 1 在 下 载 镜像 之 前 ， 其 实 还 可 以 通过 关键 字 来 搜索 镜像 文件 。 命 令 如 下 。 


docker search selenium 


36 ” 汐 Python Web 自动 化 测试 设计 与 实现 


步骤 2 在 确定 有 搜索 结果 之 后 ， 就 可 以 开始 下 载 具体 的 镜像 了 。 下 载 独立 的 Firefox 环 


境 镜像 的 命令 如 下 。 


docker pull selenium/standalone-firefox 


步骤 3 在 镜像 下 载 完成 之 后 ,使 用 如 下 命令 查看 本 地 已 下 载 的 镜像 。 


docker images 
步骤 4 运行 Selenium 的 镜像 文件 。 
docker run -it -p 4444:4444 selenium/standalone-firefox 


步骤 5 查看 启动 后 的 效果 如 图 1-32 所 示 。 


Ere -一 - > 


doch 


图 1-32 Docker 下 启动 Selenium 


上 面 的 步骤 介绍 的 是 下 载 独 立 Firefox 环境 的 镜像 ， 下 载 其 他 镜像 的 步骤 也 是 相同 
的 。 只 有 使 用 Selenium Grid 时 ， 在 启动 镜像 的 命令 上 有 一 些 区 别 。 启 动 一 个 Hub 和 一 个 


Chromenode 的 命令 如 下 。 


docker run -d -p 4444:4444 --name selenium-hub selenium/hub 
docker run -d --link selenium-hub:hub selenium/node-chrome 


1.7.3 ”Docker 下 运行 Selenium 脚本 


Docker 服务 提供 的 Selenium 环境 都 是 远程 环境 ， 所 以 运行 在 Selenium Docker 之 上 的 
测试 脚本 必须 基于 remote WebDriver 而 开发 。 以 连接 Selenium Firefox 服务 为 例 的 样 例 代码 


如 下 。 
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= codingsutf=-8. 一 “一 
from selenium.webdriver.remote import webdriver 
from selenium.webdriver.common.\ 


desired capabilities import DesiredCapabilities 


u"'"'' 打开 百度 首页 ， 输入 Selenium 进行 搜索 ''' 

driver = webdriver.WebDriver!( 
command executor="http://192.168.99.100:4444/wd/hub", 
desired capabilities=DesiredCapabilities.FIREFOX 


) 


driver.get ("http://www.baidu.com") 

assert (u" 百度 " in driver.title) 
driver.find element by id("kw").send keys ("selenium") 
driver .find element by id("su") .click() 

assert (u"selenium_ 百度 搜索 " in driver.title) 
driver.close() 

driver.quit() 


同 连接 真实 环境 一 样 ， 远 程 的 服务 地 址 既 可 以 是 Selenium Server， 也 可 以 是 Selenium 


Hub。 与 真实 


环境 不 同 的 是 ， 代 码 中 的 远程 服务 地 址 与 Docker 环境 的 不 同 。 获 取 方 式 分 为 两 


种 情况 ， 具 体 如 下 。 
1. 原生 的 Docker 环境 


所 谓 原 4 


E 的 Docker 环境 ， 是 指 按照 1.7.1 节 中 前 三 种 方式 安装 的 Docker 环境 。 在 这 种 


情况 下 宿主 机 本 身 的 IP 地 址 就 是 Selenium 的 连接 IP 地 址 。 
2. Toolbox 的 Docker 环境 


如 果 安 


装 的 是 Toolbox 的 Docker 环 境 ， 则 可 以 从 Docker 终 端的 启动 信息 中 获取 


Selenium 的 连接 IP 地 址 ， 如 图 1-33 中 标 红 的 192.168.99.100。 


vivGwet caina 


图 1-33 ”Docker 中 Selenium 连接 HOST 


注意 虽然 Selenium Docker 是 Selenium 官方 开源 的 项 目 ， 但 根据 目前 使 用 的 情况 以 及 
Github 上 问题 反馈 的 频率 来 看 ，Selenium Docker 项 目 还 未 到 非常 稳定 的 版 本 ， 可 以 作为 实验 
和 小 范围 试用 。 
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1.8 Selenium 3 说 明 


在 本 书 的 写作 和 编辑 过 程 中 ，Selenium 也 在 不 停 地 发 展 和 更 新 。 从 本 书 开始 写作 时 的 
Selenium 2 的 2.53.1 版 本 ， 到 本 书 审核 编辑 时 的 Selenium 3 的 3.1.1 版 本 。 虽 然 在 大 版 本 上 
有 所 更 新 ， 但 主要 的 更 新 还 是 集中 在 后 台 和 底层 方面 。 所 以 基于 Selenium 2 版 本 的 测试 脚 
本 ， 基 本 上 无 须 修 改 就 可 以 直接 兼容 Selenium 3 的 版 本 。 

本 小 节 主 要 介绍 Selenium 3 相对 于 Selenium 2 有 了 哪些 更 新 ， 以 便于 读者 根据 自己 的 需 
求 来 选择 使 用 哪个 版 本 。 


1.8.1 不 再 支持 Selenium RC 


Selenium RC 是 Selenium 1 的 产物 ， 在 Selenium 2 的 时 候 为 了 兼容 一 部 分 Selenium 1 的 
项 目 ， 因 此 把 Selenium RC 集成 到 了 Selenium Server 中 了 ， 统 一 发 布 为 Selenium-standalone 
包 。 而 从 Selenium 3 开始 将 完全 据 弃 对 Selenium RC 的 支持 。 


1.8.2 仅 支 持 JDK 1.8.0 以 上 版 本 


Selenium 3 开始 需要 Java 支持 的 功能 ， 都 统一 需要 JDK1 8.0 以 上 版 本 的 支持 。 比 如 
Java 版 本 的 Selenium 脚本 ; 或 者 Python 版 本 脚本 需要 用 到 的 Selenium Server。 


1.8.3 Selenium IDE 支持 Chrome 插件 


在 Selenium 2 的 时 候 ，Selenium IDE 还 只 能 支持 FireFox 插件 ， 如 今 Selenium 3 的 IDE 
已 经 同时 支持 Firefox 和 Chrome 插件 了 。 下 载 地 址 分 别 如 下 。 
Firefox 插件 下 载 地 址 如 下 。 


https://chrome.google.com/webstore/detail/selenium-ide/mooikfkahbdckldjjndioack 
balphokd 


Chrome 插件 下 载 地 址 如 下 。 


https://addons.mozilla.org/en-US/firefox/addon/selenium-ide/ 


1.8.4 ”FireFox 需要 安装 独立 驱动 


Selenium 2 的 时 候 ，Firefox 浏览 器 的 驱动 由 WebDriver 项 目 组 开发 ， 并 且 随 各 语言 
Clent 的 基础 包 同 时 发 布 ， 所 以 不 需要 额外 安装 就 可 以 直接 使 用 。 而 Selenium 3 开始 对 于 版 
本 在 Firefox 47 及 以 上 的 浏览 器 ， 必 须要 安装 geckodriver 驱动 才能 正常 运行 。 

geckodriver 驱动 的 下 载 和 使 用 步 又 如 下 。 

(1 ) 从 https://github.com/mozilla/geckodriver/releases 下 载 对 应 的 驱动 版 本 。 
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(2 ) 把 二 进 制 文件 解压 到 Firefox 的 安装 目录 。 
(3 ) 把 Firefox 的 安装 目录 添加 到 系统 环境 变量 。 
(4) 执行 如 下 代码 测试 驱动 安装 。 


import time 
from selenium import webdriver 


driver = webdriver.Firefox() 
driver.get ("http://www.baidu.com") 


driver .find element by id("kw") .clear() 

driver .find element by id("kw").send keys ("Python") 
driver .find element_by_id("su") .click() 
time.sleep(5) 

driver.quit() 


(5 ) 代码 执行 无 错误 表示 驱动 安装 成 功 。 


注意 ”geckodriver 驱动 的 不 同 版 本 对 Selenium 和 Firefox 都 有 版 本 要 求 。 在 下 载 驱动 之 
前 先 确定 待 测试 的 Firefox 版 本 ， 并 升级 相应 的 Selenium 版 本 。 而 对 于 Firefox 46 及 以 下 的 
版 本 ， 则 需要 使 用 Selenium 2 来 支持 测试 。 


1.8.5 仅 支 持 IE 9.0 以 上 版 本 


Selenium 3 对 下 浏览 器 也 进行 了 规定 ， 仅 对 下 9 及 以 上 的 版 本 进行 支持 。 对 于 需要 测 
试 低 版 本 的 卫 ]， 则 需要 使 用 Selenium 2 环境 来 支持 覆盖 。 


1.8.6 ”支持 微软 的 Edge 浏览 器 

除了 对 下 的 支持 之 外 ，Selenium 3 也 开始 支持 微软 的 Edge 浏览 器 。Edge 驱动 的 下 载 地 
址 如 下 。 

https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/ 

需要 注意 的 是 ，Edge 浏览 器 只 有 Windows 10 才 有 ， 所 以 安装 Edge 驱动 的 前 提 是 操作 
系统 为 Windows 10。 


1.8.7 ”支持 官方 的 SafariDriver 


Selenium 2 的 时 候 也 有 SafariDriver， 但 并 不 是 Apple 团 队 开发 的 。Selenium 3 开始 
Safari 官方 推出 了 自己 的 SafariDriver， 相 信 在 稳定 性 和 兼容 性 上 会 有 不 少 的 提升 。 其 下 载 
地 址 如 下 。 
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http://selenium-release.storage.googleapis.com/2.48/SafariDriver.safariextz 

另外 ，Selenium 3 也 开始 支持 Mac 系统。 自 此 Selenium 的 兼容 性 将 横 跨 Windows、 
Linux、Mac 三 大 操作 系统 平台 。 

总 体 而 言 ，Selenium 3 的 升级 有 太 多 的 结构 上 的 变化 ， 更 多 的 是 在 底层 支持 上 有 所 扩展 
的 变化 。 读 者 在 选择 Selenium 版 本 的 时 候 ， 则 需要 根据 自己 的 需求 来 确定 。 因 为 Selenium 2 
和 Selenium 3 在 浏览 器 的 支持 上 有 所 区 别 ， 针 对 老 版 本 浏览 器 可 能 还 是 需要 Selenium 2 才能 
支持 ， 而 如 果 没有 硬性 要 求 则 可 以 直接 使 用 Selenium 3。 


CHAPTER 


第 2 章 
Python 编程 基础 2 


本 书 内 容 主 要 面向 已 有 一 定 Python 基础 ， 并 考虑 在 Web 自动 化 领域 深耕 和 发 展 的 读者 。 
但 考虑 到 会 有 一 部 分 读者 可 能 之 前 并 没有 接触 或 使 用 过 Python， 本 章 内 容 主 要 是 为 那些 没有 
Python 基础 的 读者 编写 的 ， 以 使 得 这 部 分 读者 在 学 习 完 本 章 内 容 之 后 ， 也 能 完全 掌握 和 理解 
本 书 中 所 使 用 的 Python 技术 和 代码 。 


2.1 基础 语法 


2.1.1 Python 语句 执行 

Python 是 一 种 脚本 语言 ， 它 的 代码 需要 在 专门 的 解释 器 环境 下 运行 ， 并 且 Python 提供 了 
两 种 运行 方式 : 一 种 是 在 交互 式 解释 器 环境 下 运行 语句 ， 另 一 种 是 使 用 Python 脚本 运行 语句 。 
进入 Python 的 交互 式 解释 器 环境 非常 简单 ， 直 接 在 命令 行 中 输入 python， 然 后 按 回 车 
键 即 可 ， 如 图 2-1 所 示 。 


丽 cwindowsostemazemdee python ws 于 汪 本 呈 二 a 


图 2-1 Python 解释 器 命令 行 
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在 进入 Python 的 交互 式 环境 之 后 ， 就 可 以 输入 并 执行 Python 语句 了 。 例 如 ， 著 名 的 
“Hello World” 语 句 在 Python 中 的 语法 格式 如 下 。 
print "Hello World" 


执行 效果 如 图 2-2 所 示 。 


图 2-2 ”Python 执行 语句 
如 果 和 希望 使 用 Python 脚本 的 方式 来 执行 语句 ， 那 么 需要 先 新 建 一 个 空白 的 文档 ， 并 输 
入 下 面 的 代码 。 
print "Hello, Python!™" 
最 后 将 文档 保存 为 以 .py 结尾 的 Python 脚本 文件 ， 如 test.py。 之 后 就 可 以 执行 这 个 
Python 脚本 ， 在 命令 行 输入 如 下 命令 即 可 。 
python test.py 


运行 效果 如 图 2-3 所 示 。 


图 2-3 Python 脚本 执行 


注意 ”执行 上 述 代码 时 ， 请 确保 Python 已 经 安装 完成 ， 并 已 配置 好 环境 变量 。 在 执行 
脚本 文件 的 时 候 ， 需 要 先进 入 Python 脚本 文件 所 在 的 目录 。 


2.1.2 ”Python 语法 格式 
Python 的 语法 格式 比较 简单 ， 它 不 像 C、C++、Java 那样 使 用 {} 来 标识 代码 块 。Python 
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直接 使 用 缩 进 作为 代码 块 标识 ， 缩 进 的 方式 可 以 是 两 个 空格 、4 个 空格 、 一 个 Tab 等 。 通 常 
推荐 的 是 以 4 个 空格 来 作为 一 个 缩 进 。 如 果 习 惯 使 用 Tab 来 缩 进 的 话 ， 那 么 可 以 设置 IDE 的 
1 个 Tab 代表 4 个 空格 。 

值得 注意 的 是 ， 并 不 是 所 有 的 Python 缩 进 都 会 被 视 为 代码 块 。 只 有 那些 以 冒号 结尾 的 
语句 之 后 的 缩 进 才 被 认为 是 代码 块 。 一 个 典型 的 Python 脚本 语法 如 下 所 示 。 

#PYthon 语法 演示 

if True: # 以 冒号 结尾 的 语句 

print "True" 


else: 
print "False" 


从 上 述 代码 中 可 以 发 现 ，Python 的 控制 语句 是 不 需要 包含 在 0 之 中 的 ， 这 也 是 与 Java 
等 编译 型 语言 不 一 样 的 地 方 。 
在 Python 的 语法 中 使 用 “# ”开头 的 内 容 来 表示 注释 。 如 果 是 多 行 注释 ， 则 可 以 直接 使 
用 三 个 引号 来 表示 ， 代 码 如 下 。 
1 Python 
多 行 
注释 


print "Hello Python!" 


在 Python 中 一 条 语句 默认 以 新 的 换行 来 表示 结束 。 除 此 之 外 ， 还 可 以 以 分 号 来 显 式 地 
表示 结束 。 更 可 以 通过 “\” 作 为 续 行 符 来 跨行 表示 一 条 语句 。 示 例如 下 。 


a=1 # 默认 以 换行 结束 语句 

b =2; c=3 # 以 分 号 显 式 结束 语句 
d=a+\ # 使 用 续 行 符 跨行 显示 一 条 语句 
b+ \ 

c 


最 后 ，Python 标识 符 是 由 字母 、 数 字 、 下 画 线 组 成 。 所 有 标识 符 可 以 包括 英文 、 数 字 以 
及 下 画 线 (_)， 但 不 能 以 数字 开头 。 典 型 的 示例 如 下 。 


## 正确 的 示例 

abc123_ = "right’ 
ABC_123 = 'right' 
_foo = 'foo' 

_ foo = 'fo02"' 
it i" init ." 
## 错误 的 示例 

123abc_ = "wrong'" 


其 中 ， 以 下 画 线 开头 的 标识 符 是 有 特殊 意义 的 。 以 单 下 画 线 开头 (如 _foo) 的 代表 不 能 
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直接 访问 的 类 属性 ， 需 通过 类 提供 的 接口 进行 访问 ， 不 能 用 from xxx import * 而 导入 ; 以 双 
下 画 线 开头 的 (如 _foo) 代表 类 的 私有 成 员 ; 以 双 下 夯 线 开头 和 结尾 的 (如 _ foo_) 代表 
Python 里 特殊 方法 专用 的 标识 ， 如 __init _0 代表 类 的 构造 函数 。 


注意 Python 中 的 标识 符 是 区 分 大 小 写 的 。 大 小 写 不 同 的 标识 符 表示 的 是 不 同 的 内 容 。 


2.1.3 “Python 变量 与 类 型 

变量 是 计算 机 语言 中 不 可 缺少 的 一 个 名 词 ， 它 属于 标识 符 的 一 种 。 正 如 在 数学 中 变量 可 
以 代表 任意 数字 一 样 ， 在 Python 中 变量 可 以 用 来 代表 任意 类 型 的 对 象 。 每 当 我 们 给 一 个 变量 
赋值 的 时 候 ， 这 个 变量 就 代表 了 这 个 特定 的 对 象 。 变 量 创建 和 赋值 语句 如 下 。 


在 Python 中 创建 变量 不 需要 像 Java 等 语言 那样 ， 先 申明 一 个 变量 并 指定 变量 类 型 。 因 
为 Python 中 变量 本 身 是 无 类 型 区 分 的 ， 所 以 可 以 直接 创建 并 赋 以 任意 类 型 的 值 。 另 外 ， 
Python 中 所 有 的 数据 类 型 都 是 基于 Object 对 象 的 ， 从 这 个 角度 也 可 以 理解 Python 的 变量 可 
以 进行 任意 类 型 赋值 ， 因 为 本 质 上 变量 指向 的 都 是 一 个 对 象 。 

Python 中 的 变量 不 区 分 类 型 ， 但 变量 所 赋予 的 数据 却 是 有 类 型 区 分 的 。Python 常见 的 数 
据 类 型 如 下 。 

口 字符 串 (str)。 

口 整 型 (int)。 

口 长 整 型 (long)。 

口 浮 点 型 (float)。 

口 布尔 型 (boolean)。 

口 空 值 (None)。 


|. 字符 串 
字符 串 是 由 数字 、 字 母 、 符 号 等 组 成 的 一 串 用 引号 括 起 来 的 内 容 。 其 常见 的 内 容 形 式 
如 下 。 


'hello world' 

"i am 5 years old" 
"my name is jack' 7 
wwwi am stringnnn 


上 面 的 几 种 形式 都 是 正常 的 字符 串 ， 因 为 在 Python 中 规定 了 单 引 号 、 双 引号 和 三 引号 
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都 是 可 以 用 来 定义 字符 串 的 。 还 可 以 把 字符 串 赋值 给 变量 ， 代 码 如 下 。 


a=' iam5 years old 
Pin - 总 


在 Python 解释 器 环境 中 执行 上 述 两 条 语句 ， 最 终 的 命令 行 会 输出 ， 如 图 2-4 所 示 。 


BC\Windows\system32\cmd.exe - python ls 


图 2-4 Python 变量 打印 


2. 整 型 
整 型 就 是 数学 中 的 整数 类 型 ， 包 括 正 整数 、 负 整数 和 零 ， 如 1、100、0、-20 等 。Python 


中 整 型 所 能 支持 的 范围 与 计算 机 的 位 数 有 关 。 例 如 ，32 位 的 机 器 其 整数 范围 在 -22 一 2-1 


次 ， 


即 -2 147 483 648 到 2 147 483 647 之 间 。 
与 字符 串 一 样 ， 整 型 也 可 以 赋值 给 变量 。 方 式 如 下 。 


下 5 
nl 
op 
= 


口 P 1 


此 外 ， 整 型 和 字符 串 之 间 还 可 以 进行 类 型 转换 。 所 有 的 整 型 都 可 以 转换 成 字符 串 类 型 ， 


我 们 所 要 做 的 就 是 调用 一 下 str 函数 。 在 解释 器 环境 下 输入 如 下 命令 。 


str(100) 


执行 后 将 得 到 一 个 字符 串 的 内 容 ， 如 图 2-5 所 示 。 


em32\cmd.exe - Python 


图 2-5 Python 类 型 转换 


3. 长 整 型 
长 整 型 就 是 比 整 型 更 大 更 长 的 整 型 ， 即 超出 整 型 范围 的 整 型 数字 都 属于 长 整 型 。 例 如 ， 


32 位 机 器 下 的 2 147 483 648、-2 147 483 649。 在 Python 中 定义 长 整 型 有 两 种 方式 : 一 种 是 
显 式 的 定义 ， 另 一 种 是 隐 式 的 定义 。 具 体 如 下 所 示 。 
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n = 100L # 显 式 地 以 工 结尾 ， 推 荐 定义 方式 
k= 11 # 显 式 地 以 小 写 1 结尾 
m = 2147483648 # 数字 直接 超出 普通 整 型 范围 


上 面 定义 的 三 个 变量 内 容 所 属 的 类 型 都 是 长 整 型 。 有 些 读者 可 能 会 想到 以 大 小 写 工 结尾 
的 显 式 定义 ， 可 以 很 方便 地 知道 是 长 整 型 ， 而 以 隐 式 方式 定义 的 数字 怎么 快速 地 确定 它 的 类 
型 呢 ? 答案 是 使 用 type 函数 来 查看 变量 值 的 类 型 ， 使 用 方式 如 下 。 


i = 2147483647 


type (i) #int 
j = 2147483648 

type (j) #1long 
h=1L 

type (h) #1long 


解释 器 环境 下 执行 上 述 命 令 后 的 效果 如 图 2-6 所 示 。 


画 CWindovs\system3Nemd ee - Python 


一 Eh 


图 2-6 ”Python 变量 类 型 查看 1 


4. 浮 点 型 


浮 点 型 对 应 的 是 数学 中 的 小 数 ， 例 如 ，1.23、3.1415、-20.37。 除 了 常规 的 小 数 表 示 法 
之 外 ,在 Python 中 还 可 以 使 用 科学 计数 法 来 表示 浮 点 数 。 例 如 ，1.23 也 可 以 表示 为 12.3 乘 


以 10", 具体 表示 为 12.3e-1。 浮 点 型 的 数值 赋值 方式 如 下 。 


f= 1.23 
type (£) 
£1 se 2.36-1 
type (£1) 
f2=1.0 
type (£2) 


上 述 语句 在 解释 器 环境 执行 的 效果 如 图 2-7 所 示 。 


图 2-7 Python 变量 类 型 查看 2 
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5. 布尔 型 
布尔 型 数据 在 程序 中 只 有 两 个 值 ， 即 真 和 非 真 。 在 Python 中 使 用 True 表示 真 ，False 表 
示 非 真 。 布 尔 值 可 以 通过 直接 赋值 的 方式 获得 ， 如 下 所 示 。 


或 者 是 通过 布尔 运算 获得 布尔 数值 ， 如 下 所 示 。 


a=3>2 ##True 
b = True and False ##False 
C = True or False ##True 
d= not True ##False 


布尔 数值 通常 会 在 条 件 判断 中 使 用 。 在 2.2 节 的 控制 语句 中 ， 将 介绍 如 何 使 用 布尔 值 进 
行 条 件 判 断 。 


提示 虽然 布尔 值 只 有 True 和 False， 但 在 条 件 判断 表达 式 中 其 他 类 型 的 数据 也 有 布尔 
值 的 等 效 作用 。 例 如 ， 字 符 串 中 的 空 串 、 整 型 中 的 0 对 应 的 布尔 值 为 False， 其 他 数值 都 对 应 


True。 


6. 空 值 

空 值 在 Python 中 是 指 没有 任何 内 容 的 值 ， 它 既 不 是 0 也 不 是 空 串 ， 可 以 直接 理解 为 空 。 
在 Python 中 使 用 None 来 表示 ， 它 在 条 件 判断 表达 式 中 与 False 有 等 效 的 值 。 空 值 通常 只 能 
通过 赋值 来 获得 。 方 式 如 下 。 


a = None 


2.1.4 “Python 运算 符 与 表达 式 

运算 符 指 的 是 可 以 对 操作 数 进行 运算 的 操作 符 。 例 如 ，2+3 中 的 + 就 是 运算 符 ， 而 2 和 
3 就 是 操作 数 。 在 Python 中 像 这 样 的 运算 符 有 很 多 ， 并 且 可 以 分 为 不 同 的 类 。 主 要 的 运算 符 
分 类 如 下 所 示 。 

口 算术 运算 符 。 

口 比较 运算 符 。 

口 逻辑 运算 符 。 

口 位 运算 符 。 

口 赋值 运算 符 。 

口 成 员 运算 符 。 


48 阔 Python Web 自动 化 测试 设计 与 实现 


口 身份 运算 符 。 


1. 算术 运算 符 

算术 运算 符 是 指 可 以 进行 算术 运算 的 操作 符 。Python 中 算术 运算 符 有 如 下 几 种 。 

口 +: 加 运算 符 用 于 两 个 数 相 加 。 如 : 1+2， 结 果 为 3。 

口 -: 减 运算 符 用 于 得 到 负数 或 是 一 个 数 减 去 另 一 个 数 。 如 : -10 表示 负数 , 5-3， 结 果 为 2。 

口 *: 乘 运算 符 用 于 两 个 数 相 乘 。 如 : 2*3， 结 果 为 6。 

口 /: 除 运算 符 用 于 一 个 数 除 以 另 一 个 数 。 如 : 5/2， 结 果 为 2，5.0/2， 结 果 为 2.5。 

口 /: 取 整 除 运算 符 用 法 与 “/” 运 算 符 作 用 相同 ， 但 它 只 会 返回 商 数 中 的 整数 部 分 。 如 : 

5.0/2， 结 果 为 2.0。 

口 %: 取 模 运算 符 用 于 返回 除法 余数 。 如 : 5%3， 结 果 为 2。 

口 ** : 寡 运 算 符 用 于 求 数 的 次 方 。 如 : 2**3 表示 2 的 3 次 方 ， 结 果 为 8。 

在 上 面 所 列 的 运算 符 中 ， 只 有 /和 /运算 符 需 要 注意 。/ 运算 符 在 整数 除 以 整数 的 情况 下 
结果 也 会 是 整数 ， 想 要 得 到 小 数 部 分 的 数据 ， 则 要 替换 其 中 任意 一 个 整数 为 对 应 的 浮 点 型 ， 
如 下 所 示 。 


wm wm w 
o~o~、 
和、 
DO 


/运算 符 也 被 叫 作 地 板 除 运算 符 ， 它 永远 只 会 返回 商 数 中 的 整数 部 分 ， 效 果 如 下 。 


2 // 4 
4//2 
A/ 
下 YY 大 将 
0 417 


II ND 口 


Pen 


Ze0 
2.0 


2. 比较 运算 符 

比较 运算 符 主要 用 于 对 操作 数 进行 比较 。Python 中 比较 运算 符 有 如 下 几 种 。 

口 >: 检查 左边 操作 数 是 否 大 于 右边 操作 数 。 如 : 3 > 2， 结 果 为 True。 

口 <: 检查 左边 操作 数 是 否 小 于 右边 操作 数 。 如 : 3 < 2， 结 果 为 False。 

口 一 : 检查 左边 操作 数 是 否 等 于 右边 操作 数 。 如 : 2 == 2， 结 果 为 True。 

口 >=: 检查 左边 操作 数 是 否 大 于 或 者 等 于 右边 操作 数 。 如 : 2 >= 2， 结 果 为 True。 

口 <=: 检查 左边 操作 数 是 否 小 于 或 者 等 于 右边 操作 数 。 如 : 2 <= 2， 结 果 为 True。 

口 =: 检查 左边 操作 数 是 否 不 等 于 右边 操作 数 。 如 : 2 != 2， 结 果 为 False。 

经 过 比较 运算 符 操作 后 得 到 的 结果 为 布尔 型 。 即 其 运算 结果 只 有 True 和 False 这 两 种 ， 
当 比 较 条 件 满足 运算 符 时 结果 为 True， 否 则 为 False。 


3. 逻辑 运算 符 
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逻辑 运算 符 主 要 用 来 做 逻辑 运算 ， 即 对 真 和 假 做 逻辑 运算 。 运 算 符 有 如 下 几 类 。 

口 and : 逻辑 与 运算 符 。 该 运算 符 两 边 操作 数 全 为 真 时 结果 为 真 ， 否 则 结果 为 假 。 例 如 ， 
True and True 为 True，True and False 为 False。 

口 or : 逻辑 或 运算 符 。 该 运算 符 两 边 操作 数 全 为 假 时 结果 为 假 ， 否 则 结果 为 真 。 例 如 ， 


False or False 为 False，True or False 为 True。 


口 not : 逻辑 非 
False 为 True 


运算 符 。 该 运算 符 对 操作 数 进行 取 反 操 作 。 例 如 ，not True 为 False，not 


o 


提示 在 Python 中 有 一 个 情 性 计算 的 概念 ， 其 中 的 一 种 支持 方式 就 是 逻辑 或 运算 符 。 
具体 而 言 就 是 在 使 用 or 运算 符 时 ， 如 果 其 左 侧 的 操作 数 为 True 则 会 直接 返回 结果 ， 不 再 对 
其 右 侧 操作 数 进 行 检查 。 因 为 在 该 条 件 下 不 论 右 侧 是 否 为 True， 返 回 的 结果 都 将 为 True， 所 
以 右 侧 的 检测 可 以 省 略 掉 。 


4. 位 运算 符 


位 运算 符 用 于 对 操作 数 进行 二 进 制 按 位 运算 。 在 计算 中 任何 的 数 最 终 都 会 以 二 进 制 的 方 
式 表 示 ， 而 我 们 通常 所 用 到 的 十 进 制 数 也 一 样 可 以 用 二 进 制 表示 。 例 如 ,十进制 中 的 12 对 
应 二 进 制 的 1100， 十进制 的 20 对 应 二 进 制 中 的 10100。 那 么 当 我 们 使 用 位 运算 符 对 12 和 20 
进行 位 运算 时 ， 实 际 上 就 是 对 1100 和 10100 进行 位 运算 。 位 运算 有 如 下 几 类 。 

口 &: 按 位 与 运算 符 。 对 操作 数 的 对 应 位 进行 与 运算 。 

口 |: 按 位 或 运算 符 。 对 操作 数 的 对 应 位 进行 或 运算 。 

口 ^ : 按 位 异 或 运算 符 。 对 操作 数 的 对 应 位 进行 异 或 运算 ， 即 对 应 位 的 数 相 异 则 为 真 ， 


否则 为 假 。 
口 ~: 按 位 取 反 


运算 符 。 对 操作 数 的 每 一 位 依次 进行 取 反 。 


口 <<: 左 移 运 算 符 。 把 操作 数 的 所 有 位 向 左 移动 指定 位 数 。 
口 >>: 右 移 运算 符 。 把 操作 数 的 所 有 位 向 右 移动 指定 位 数 。 


位 运算 符 运算 样 例 结果 如 下 。 

x = 01100 #12 

y = 10100 #20 

x&y #=> 00100 # 按 位 与 
x | Y #=> 11100 # 按 位 或 
EY #=> 11000 # 按 位 异 或 
~x #=> 10011 # 按 位 取 反 
X<<2 #=> 110000 # 按 位 左 移 
Y>>2 #=> 00101 # 按 位 右 移 
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5. 赋值 运算 符 


赋值 运算 符 主要 用 于 把 表达 式 的 运算 结果 或 数值 赋值 为 变量 。Python 中 支持 的 赋值 运算 
符 如 下 。 
口 =: 最 基本 的 赋值 运算 符 。 如 : a= 4， 表 示 把 4 赋值 为 a 变量 ， 那 么 a 的 值 就 是 4。 


口 +=: 加 法 运算 符 。a +=b 等 价 于 a=a+b。 
口 -=: 减法 运算 符 。a -=b 等 价 于 a=a-b。 
口 *=: 乘法 运算 符 。a *=b 等 价 于 a=a*b。 
口 =: 除法 运算 符 。a 三 b 等 价 于 a=a/b。 

口 /三 : 地 板 除 运算 符 。a /三 b 等 价 于 a=a//b。 
口 %=: 取 余 运算 符 。a %=b 等 价 于 a=a%b。 
口 **=: 寡 运 算 符 。a **=b 等 价 于 a=a**b。 


6. 成 员 运 算 符 


成 员 运 算 符 用 于 测试 集合 对 象 中 是 否 包括 特定 的 成 员 。 支 持 该 运算 符 的 集合 包括 : 


元 组 、 列 表 、 字 典 、 集 合 (set) 等 。 成 员 运 算 符 分 类 如 下 。 
口 in: 判断 成 员 是 否 存在 于 集合 中 。 
口 not in: 判断 成 员 是 否 不 存在 于 集合 中 。 


成 员 运 算 符 的 使 用 样 例如 下 。 

a= [1，2，3，4] 

区 洪 #=> True 
沪 条 球台 #=> False 
5 not in a #=> True 
7. 身份 运算 符 


身份 运算 符 用 于 比较 两 个 对 象 是 否 为 相同 的 存储 单元 。 所 谓 的 相同 存储 单元 即 同一 


字符 


个 内 


存 存储 地 址 。 如 果 用 身份 运算 符 确认 了 存储 单元 相同 ， 则 比较 的 两 个 对 象 即 为 同一 个 对 象 。 
身份 运算 符 的 种 类 如 下 。 


口 is: 判断 两 个 对 象 是 否 引用 自 同一 个 地 址 。 
口 is not: 判断 两 个 对 象 是 否 出 自 不 同 的 地 址 。 


身份 运算 符 的 使 用 样 例如 下 。 

x= 10 

了 一式 

z=+1 

x isy #=>True 
区 注 和 名 #=>False 
x is not z #=>True 
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8. 运算 符 优先 级 

前 面 已 经 学 习 了 Python 中 的 运算 符 成 员 。 它 们 不 仅 分 门 别 类 还 可 以 同时 使 用 出 现在 表 
达 式 中 ， 而 当 它 们 同时 使 用 时 就 会 有 优先 级 顺序 的 问题 。 同 其 他 语言 一 样 ， 在 Python 中 不 同 
运算 符 之 间 也 会 有 不 同 的 优先 级 顺序 。 具 体 的 顺序 由 高 到 低 排 列 如 下 。 

口 ** : 寡 运 算 符 。 

口 ~: 按 位 取 反 运算 符 。 

口 *、/、%、//: 高 阶 算术 运算 符 。 

口 +、-: 算术 运算 符 。 

口 >>、<<: 位 移 运 算 符 。 

口 &: 人 逻辑 与 运算 符 。 

口 ^、|: 逻辑 或 、 异 或 运算 符 。 

口 <=、<>、>=: 比较 运算 符 。 

==、!=: 比较 运算 符 。 

口 =、%=、/=、/H=、+=、 一 、#+=、*+=: 赋值 运算 符 。 

口 is: 身份 运算 符 。 

口 in: 成 员 运 算 符 。 

口 and、or、not: 逻辑 运算 符 。 

上 面 的 运算 符 中 ， 相 同 优 先 级 的 运算 符 其 优先 级 顺序 按照 从 左 至 右 先 出 现 先 运算 的 原 
则 。 例 如 ,+ 和 - 的 优先 级 相同 ， 则 先 在 左 侧 出 现 的 优先 级 更 高 。 


+2-3 #+ 优先 级 高 
-2+3 #- 优先 级 高 


除了 上 面 所 列 出 的 默认 优先 级 之 外 ， 如 果 想 提升 某 些 运算 符 的 优先 级 ， 可 以 使 用 0 来 实 
现 。 例 如 ，* 的 优先 级 高 于 + 的 优先 级 ， 正 常 结 果 如 下 。 


KK=2+3*5 #=> 17 
如 果 提 升 了 + 运算 符 的 优先 级 ， 则 结果 会 不 一 样 ， 如 下 所 示 。 
xX= (2+3)*5 #=> 25 

9. 表达 式 


所 谓 的 表达 式 就 是 指使 用 各 种 运算 符 和 操作 数组 成 的 算术 式 。 最 常见 的 表达 式 形式 
如 下 。 


a = 过 # 赋值 表达 式 
Bcs3 # 连续 赋值 表达 式 
a+=1 

d=b+c # 数字 + 赋值 表达 式 
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e = aandb # 逻辑 + 赋值 表达 式 
f=b>c # 比 较 + 赋值 表达 式 
g=a+b>(c+d)*3ore # 混合 表达 式 


与 其 他 语言 不 同 的 是 ，Python 中 除了 可 以 支持 上 面 列 出 的 普通 表达 式 之 外 ， 还 支持 具有 
特定 功能 的 表达 式 ， 它 们 分 别 如 下 。 

口 []: 列表 解析 表达 式 。 

口 0: 生成 器 表达 式 。 

口 lambda: Lambda 表达 式 。 

这 些 表 达 式 具有 一 些 不 一 样 的 功能 ， 由 于 部 分 知识 点 还 没有 讲 到 ， 将 会 在 后 面 的 章节 中 
一 一 介绍 。 


2.2 ”控制 语句 


到 目前 为 止 已 经 学 习 了 Python 的 一 些 基础 语法 ,可 以 对 变量 进行 赋值 ， 对 数据 进行 比 
较 等 。 但 只 有 这 些 还 不 够 ,还 要 对 程序 流程 进行 控制 ， 并 确定 在 不 同 条 件 下 执行 不 同 的 程序 
代码 。 本 节 学 习 Python 中 的 控制 语句 ， 主 要 有 如 下 几 类 控制 语句 。 

口 条 件 判断 控制 语句 ， 如 if-else。 

口 循环 控制 语句 ， 如 for、while。 

口 跳出 循环 控制 语句 ， 如 continue、break。 

口 空 语句 ， 如 pass。 


2.2.1 if-else 语句 


if-else 属于 条 件 判断 控制 语句 ， 可 以 通过 该 控制 语句 来 判断 表达 式 是 否 成 立 ， 并 且 可 以 
对 不 同 的 结果 进行 分 支 处 理 。if-else 语句 的 使 用 格式 如 下 。 


if express: 
statement to execute 
else: 
other statement to execute 


上 面 的 使 用 方式 只 是 其 中 的 一 种 ， 还 可 以 只 使 用 语句 ， 也 可 以 使 用 多 个 站 判断 语句 。 
具体 相关 示例 如 下 。 


人 True: 
print "ok" 


score = 80 
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if score > 85: 
print 'great' 


elif score > 75: ##match this condition 
print 'well' ##print this statement 
elif score > 60: 
print 'ok' 
else: 


print 'fighting'" 


2.2.2 for 语句 


for 语句 属于 循环 控制 语句 ， 可 以 用 来 控制 循环 人 遍历。 例如， 重复 做 一 些 相同 或 关联 操 
作 。for 语句 的 使 用 格式 如 下 。 


for item in collection: 
statement to execute 


for 循环 最 常 使 用 的 一 个 场景 就 是 遍历 集合 。 例 如 ， 对 字符 串 进行 遍历 的 操作 如 下 。 


= "be” 
for ch in s: 
print ch 


上 面 代码 执行 的 结果 如 下 。 


a 
b 


除了 遍历 字符 串 之 外 ， 还 可 以 遍历 列表 、 元 组 等 。 比 较 特殊 的 是 ，Python 中 无 法 直接 遍 
历数 字 。 要 想 遍 历数 字 ， 需 要 先生 成 一 个 数字 的 列表 ， 然 后 再 遍历 该 列表 。 遍 历数 字 的 代码 
如 下 。 


num = [1, 2, 3] 
for i in num: 


print i 
上 述 代码 执行 后 的 结果 如 下 。 
1 
知 
3 


2.2.3 ”while 语句 


while 语句 也 属于 循环 控制 语句 ， 它 的 作用 与 for 循环 基本 一 致 ， 只 是 在 使 用 方式 上 有 所 
区 别 。while 语句 的 使 用 格式 如 下 。 
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while express: 
statement to execute 


while 属于 单一 条 件 判断 的 循环 ， 它 不 会 去 遍历 集合 的 内 容 。while 最 常见 的 一 种 使 用 方 
式 如 下 。 


站 二 1 
while n < 5: 
print n 


上 述 代码 执行 后 的 结果 如 下 。 


ww N 


2.2.4 ”continue 语句 


continue 属于 循环 退出 语句 ， 即 它 只 能 在 for 或 while 循环 中 使 用 ， 其 作用 就 是 退出 本 
次 循环 直接 进入 下 次 循环 。 例 如 ， 在 遍历 字符 串 时 ， 打 印 其 中 所 有 的 字母 o， 则 其 实现 可 以 
如 下 。 


for ch in 'Hello Python' : 
if ch != ‘oOo': 
continue # 跳出 本 次 循环 
Print ch 
上 述 代码 中 , 在 for 循环 体内 先 判断 本 次 循环 的 字母 是 否 为 o， 如 果 不 是 则 跳出 本 次 循 
环 而 不 再 执行 后 面 的 语句 ， 如 果 是 则 会 继续 执行 后 面 的 print 语句 。 其 执行 结果 如 下 。 


0 


2.2.5 ”break 语句 


break 语句 也 是 循环 退出 语句 ， 它 也 只 能 在 for、while 循环 体内 使 用 。 而 与 continue 不 
同 的 是 ，break 语句 会 跳出 当前 所 在 的 整个 循环 ， 直 接 执行 当前 循环 之 外 的 代码 。 同 样 的 代 
码 如 果 把 continue 替换 为 break 其 效果 会 截然 不 同 。 修 改 后 的 代码 如 下 。 


for ch in "Hello Python' : 
if eh l= ‘os 
break # 跳出 整个 循环 
print ch 


上 述 代码 执行 后 不 会 输出 任何 内 容 ， 因 为 当 第 一 次 循环 判断 条 件 不 满足 时 ， 就 直接 退出 
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了 整个 循环 ， 而 不 再 继续 遍历 剩余 的 内 容 了 。 


2.2.6 ”pass 语句 


pass 语句 是 Python 独 有 的 语句 ， 它 的 作用 就 是 占用 一 个 代码 行使 语法 生效 ， 而 实际 上 
pass 语句 不 会 做 任何 的 事情 。 那 么 它 在 哪些 场景 可 以 用 到 呢 ? 使 用 示例 如 下 。 


def foo(): 
pass ## 定义 一 个 空 函数 


try: 
0 /1 
except: 


pass ## 对 捕获 的 异常 不 做 任何 处 理 
上 述 两 个 使 用 场景 中 ， 虽 然 pass 语句 没有 做 任何 事情 ， 但 却 是 不 可 少 的 语句 。 因 为 一 旦 
少 了 pass 句 就 会 在 语法 上 有 错误 ，pass 语句 就 是 为 了 语法 有 效 而 填充 一 个 空白 行 。 而 其 实 这 
里 的 pass 语句 也 可 以 使 用 print 等 其 他 无 实质 逻辑 影响 的 语句 替代 。 


2.3 ”模块 化 


有 了 控制 语句 之 后 就 可 以 写 出 复杂 功能 的 程序 ， 但 如 果 想 要 代码 整洁 有 序 、 易 读 易 改 ， 
那么 就 需要 有 模块 化 的 支持 。 在 Python 中 可 以 支持 模块 化 的 方式 有 以 下 三 种 。 

口 函数 。 

口 类 。 

口 模块 文件 。 


2.3.1 函数 


函数 是 所 有 语言 都 支持 的 模块 化 功能 ， 可 以 把 一 段 常用 的 代码 存放 到 函数 模块 中 ， 在 之 
后 需要 用 到 的 地 方 ， 只 需 直 接 调 用 该 函数 即 可 ， 而 无 须 重新 编写 一 份 相同 的 代码 。 


1. 函数 定义 
在 Python 中 一 个 最 简单 的 函数 定义 如 下 。 


def foo(): 
Pass 


上 述 代码 中 ，def 是 定义 函数 的 关键 字 ，foo 为 函数 的 名 字 ， 而 函数 体内 容 默 认为 空 ， 即 
这 是 一 个 空 函 数 。 或 者 也 可 以 定义 一 个 只 有 一 条 打印 语句 的 函数 ， 内 容 如 下 。 


def foo(): 
print “hello Python" 
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其 调用 方式 如 下 。 


foo () #=> hello Python 


2. 位 置 参数 
上 面 的 函数 只 是 一 个 固定 功能 的 函数 ， 它 永远 只 打印 相同 的 内 容 。 如 果 希 望 拥 有 一 个 可 
以 打印 不 同 内 容 的 函数 ， 就 需要 定义 一 个 带 参数 的 函数 ， 内 容 如 下 。 


def foo(s) : 
print s 


这 样 就 可 以 在 调用 该 函数 时 传人 不 同 的 内 容 ， 那 么 函数 在 执行 时 就 会 打印 不 同 的 内 容 。 
其 调用 效果 如 下 。 


foo ("hello") #=> hello 
foo("python") #=> python 


或 者 希望 创建 一 个 具有 通用 逻辑 的 函数 ， 那 么 就 可 以 创建 带 参数 的 函数 。 例 如 ， 下 面 的 
加 法 函数 。 


def add(x, y): 
return x+y 


该 函数 提供 了 一 个 通用 的 加 法 器 功能 ， 只 要 输入 两 个 数值 ， 那 么 它 会 返回 这 两 个 数值 的 
相 加 之 和 。 其 调用 方式 如 下 。 


add(1, 2) #=> 3 
add(3, 7) #=> 10 
add(10, 1.5) #=> 11.5 


上 面 的 函数 在 传人 不 同 的 参数 情况 下 ， 会 返回 对 应 的 相 加 之 和 ， 而 程序 中 有 用 到 加 法 的 
地 方 都 可 以 调用 该 函数 。 
这 种 定义 方式 的 函数 参数 叫 位 置 参数 。 即 在 调用 函数 时 传人 的 参数 与 函数 在 接收 参数 时 
位 置 是 保持 一 致 的 。 例 如 , add(1, 2) 调用 函数 时 ， 其 函数 参数 值 分 别 为 x=1,y=2， 而 add(2, 1) 
调用 函数 时 ， 其 函数 参数 值 分 别 为 x=2，y=1。 


3. 关键 字 参 数 
Python 中 还 有 一 种 函数 参数 叫 作 关键 字 参 数 。 这 种 方式 定义 的 函数 有 以 下 两 个 特点 。 
口 函数 定义 时 必须 指定 默认 值 。 

口 函数 调用 时 可 以 指定 参数 名 。 

如 下 定义 了 一 个 使 用 关键 字 参 数 的 函数 。 


def sub (x=0，Y=0) : 
return x - Y 
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对 于 全 部 使 用 关键 字 参 数 的 函数 ， 其 实 可 以 不 传 参数 来 直接 调用 ， 例 如 : 

Sub () #=> 0 

之 所 以 在 调用 时 不 需要 传 参数 ， 是 因为 函数 在 定义 时 使 用 了 默认 值 。 当 然 更 多 时 候 我 们 
都 会 带 上 参数 来 使 用 它 ， 例 如 : 


sub(2, 1) #=> 1 
sub (1，2) #=> -1 


可 能 读者 会 发 现 这 里 的 调用 方式 与 之 前 的 位 置 参数 调用 方式 是 一 样 的 。 这 是 因为 关键 字 
参数 也 支持 位 置 参数 的 调用 方式 。 作 为 位 置 参 数 调用 时 只 要 不 指定 参数 名 即 可 。 而 作为 关键 
字 参 数 的 调用 方式 如 下 。 


于 
2 
= 


sub (x=2, y=1) 
sub (y=1, x=2) 
sub (x=1, y=2) 
sub (y=2, x=1) 


从 返回 结果 可 以 知道 ， 函 数 的 参数 值 在 调用 时 通过 参数 名 被 指定 了 ， 而 不 再 跟 具 体 的 参 
数位 置 相关 。 


4. 动态 参数 

动态 参数 是 指 函 数 的 参数 数量 是 可 以 动态 变化 的 ， 也 可 称 为 可 变 长 参数 。 在 之 前 所 有 的 
例子 中 函数 的 参数 都 是 固定 的 ， 所 以 在 调用 和 接收 时 也 只 能 使 用 固定 数量 的 参数 。 

但 在 另外 的 一 些 场景 中 我 们 可 能 希望 函数 的 参数 数量 是 可 变 长 的 ， 从 而 方便 我 们 动态 地 
传递 参数 。 例 如 ， 有 一 个 求 和 函数 sum， 它 可 以 返回 所 有 输入 参数 的 相 加 总 和 ; 如 果 我 们 使 
用 固定 参数 ， 那 么 该 函数 只 能 给 固定 数量 的 数 求 和 ; 而 如 果 换 成 动态 参数 ， 那 么 就 可 以 给 任 
意 多 的 数 求 和 。sum 函数 可 以 定义 如 下 。 

def sum(*num): 

temp = 0 
for n in num: 


temp += mn 
return temp 


可 以 看 到 动态 参数 定义 的 特点 是 : 在 参数 名 之 前 加 上 一 个 * 符号 。 通 过 这 种 形式 定义 的 
函数 参数 num 是 一 个 数组 ， 它 会 接收 所 有 的 传人 参数 ， 所 以 在 函数 体 中 可 以 直接 遍历 全 部 的 
参数 并 相 加 。 现 在 就 可 以 使 用 不 同 数量 的 参数 来 调用 sum 方法 了 ， 如 下 所 示 。 

sum(1) #=> 1 


sum(1l, 2) #=> 3 
sum(1l, 2, 3) #=> 6 


人 
YYYYV 


扩 厘 太 折 
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上 面 的 动态 参数 只 能 动态 接收 位 置 参数 ， 而 想 要 动态 地 接收 关键 字 参 数 则 需要 另 一 种 定 
义 形 式 ， 具 体 如 下 。 


def foo(**kargv): 
for k，V in kargv.items(): 
Brint ky VY 


会 发 现 动态 关键 字 参 数 比 动态 位 置 参 数 仅 多 了 一 个 * 符号 。 而 为 了 更 直观 地 观察 动态 参 
数 的 内 容 ， 我 们 在 函数 体 中 直接 遍历 并 打印 了 参数 的 内 容 。 其 调用 效果 如 下 。 


foo (x=1, y=2, z=3) 
Re 


#=> 'y', 2 
#=> 'z', 3 

foo (name='macy'，age=23， sex='male') 
#=> 'name', 'macy'" 

#=> 'age', 23 

#=> 'sex', 'male' 


另外 需要 注意 的 是 ， 位 置 参数 、 关 键 字 参数 和 可 变 参 数 都 是 可 以 同时 存在 的 。 即 它们 可 
以 混合 使 用 ,但 在 定义 时 需要 有 一 个 严格 的 顺序 。 位 置 类 参数 最 先 定义 ， 其 次 为 关键 字 类 参 
数 ， 之 后 为 动态 位 置 参 数 ， 最 后 为 动态 关键 字 参 数 。 


5. 匿名 函数 

前 面 介绍 的 函数 在 定义 时 都 指定 具体 的 函数 名 ， 而 如 果 在 定义 函数 时 没有 具体 的 函数 
名 ， 那 么 这 个 函数 就 是 一 个 匿名 函数 。 在 Python 中 定义 匿名 函数 使 用 的 不 是 def 关键 字 ， 而 
是 lambda 关键 字 ， 严 格 来 说 在 Python 中 叫 作 Lambda 表达 式 。 

一 个 简单 的 Lambda 表达 式 的 定义 形式 如 下 。 

lambda x: x 

可 以 看 到 lambda 关键 字 之 后 没有 函数 名 ， 而 只 有 一 个 参数 x， 而 它 的 函数 体 也 只 有 一 个 
Xx， 当 然 也 可 以 替换 成 其 他 具有 特定 功能 的 表达 式 。 该 匿名 函数 的 功能 等 同 于 如 下 函数 。 


def foo (x) : 
return x 


如 果 想 定义 带 多 个 参数 的 匿名 函数 ， 其 具体 定义 方式 如 下 。 
lambda x, y: X+Y 


该 匿名 函数 的 功能 等 效 于 如 下 函数 。 


def foo(x，Y) : 
return X + Y 
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通常 匿名 函数 都 会 作为 其 他 函数 的 传人 参数 来 使 用 ， 而 如 果 和 希望 直接 调用 匿名 函数 ， 可 
以 使 用 如 下 的 方式 


foo = lambda x: x # 赋值 给 一 个 变量 
foo (1) # 调用 该 变量 
(lambda x: x) (1) # 使 用 括 弧 间接 调用 


最 后 总 结 一 下 匿名 函数 (Lambda 表达 式 ) 的 几 个 特点 。 
口 功能 和 使 用 上 与 普通 函数 一 样 。 

口 没有 函数 名 。 

口 函数 体 不 能 显 式 地 使 用 return 语句 。 

口 函数 体 只 能 是 一 个 表达 式 。 


2.3.2 ”类 与 实例 


类 是 面向 对 象 语言 才 有 的 概念 。 它 的 主要 作用 是 把 一 系列 相关 的 方法 和 属性 都 封装 到 一 
个 实例 内 。 从 包含 关系 上 来 讲 ， 它 是 函数 的 超 集 。 通 常 类 都 会 包含 一 组 数据 以 及 操作 这 些 数 
据 的 函数 方法 。 

Python 中 一 个 简单 的 类 可 以 定义 如 下 。 


class MyClass () : 
def _init (self): 
pass 


从 上 面 可 以 看 出 定义 类 的 关键 字 是 class， 在 其 后 紧 跟 的 就 是 类 名 MyClass。 这 个 类 目前 
只 有 一 个 初始 化 方法 _ init _， 它 在 类 实例 的 过 程 中 会 被 调用 到 。 上 面 的 类 其 实 什 么 功能 都 
没有 定义 ， 而 接 下 来 我 们 可 以 定义 一 些 具有 特定 功能 的 类 。 

class MyClass () : 


def _init_ (self, name): 
self.name = name 


def say(self) : 
print 'hello ', self.name 


上 面 的 这 个 类 具有 打印 欢迎 词 的 功能 ， 其 具体 的 实例 方式 如 下 。 


myObject = MyClass('macy') # 实例 化 类 

myObject .say() # 调用 类 的 对 象 方法 

#=> hello macy 

从 代码 中 可 以 发 现 ， 类 的 实例 化 与 函数 的 调用 很 相似 ， 类 的 参数 其 实 就 是 _init “方法 
的 参数 。 与 函数 不 同 的 是 ， 类 的 实例 化 永远 只 返回 它 的 实例 对 象 。 通 常 大 部 分 的 类 方法 都 需 
要 通过 对 象 来 调用 ， 所 以 在 使 用 类 方法 之 前 ， 一 般 都 需要 先 实例 一 个 类 的 对 象 。 
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提示 可 以 把 类 看 作 是 一 个 基础 的 模型 ， 而 实例 则 是 由 该 类 所 “ 铸 ” 出 来 的 产物 ， 称 之 
为 对 象 。 在 类 的 定义 中 使 用 self 来 表示 具体 的 对 象 。 一 个 类 可 以 实例 出 任意 多 个 对 象 ， 并 且 
所 有 对 象 在 初始 时 都 具有 相同 的 功能 。 


除了 通过 实例 对 象 来 调用 方法 外 ， 也 可 以 通过 类 本 身 来 调用 方法 ， 主 要 方式 有 : 静态 方 
法 和 类 方法 。 要 定义 静态 方法 只 要 在 定义 方法 时 添加 特定 的 注解 即 可 ， 如 下 所 示 。 


class MYC1lass () : 
def _ init__ (self) : 
pass 


@staticmethod 
def say (name) : 
print 'hello ', name 


上 述 代 码 中 给 方法 say 添加 了 一 个 @staticmethod 注解 ， 有 了 这 个 注解 Python 解释 器 就 
会 知道 这 个 方法 是 静态 方法 ， 通 过 类 也 可 以 直接 调用 。 另 外 会 发 现 say 方法 少 了 一 个 self 参 
数 ， 因 为 当 通过 类 调用 的 时 候 还 没有 进行 实例 化 ， 也 就 没有 self 参 数 传 给 它 。 静 态 方法 的 调 
用 代码 如 下 。 

MyClass.say ('macy') #=> hello macy 


而 类 方法 的 定义 则 与 实例 方法 类 似 ， 具体 如 下 。 


class MyClass () : 
def _ init__ (self): 
pass 


@classmethod 
def saylcls, name): 
print 'hello ', name 


从 上 述 代码 中 可 以 看 到 ， 定 义 类 方法 时 ， 需 要 添加 @classmethod 注解 ， 它 用 来 告知 
Python 解释 器 ， 这 是 一 个 类 方法 。 同 时 say 方法 的 第 一 个 参数 换 成 了 cls， 它 代表 MyClass 类 
本 身 。 类 方法 的 调用 如 下 。 

MyClass.say('macy') #=> hello macy 

类 除了 能 把 数据 和 方法 封装 在 一 起 之 外 ， 还 有 一 个 特性 就 是 可 以 支持 继承 。 有 了 继承 的 
功能 之 后 ， 类 与 类 之 间 可 以 有 继承 关系 ， 被 继承 的 为 父 类 ， 继 承 的 为 子 类 。 子 类 可 以 拥有 父 
类 的 所 有 开放 数据 和 方法 ， 而 无 须 再 另外 编写 一 份 。 类 继承 定义 方式 如 下 。 

class Person() : # 父 类 


def _init__ (self, name): 
self.name = name 
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def say(self) : 
Print "my name is ', self.name 


class Man (person) : # 子 类 
pass 


上 述 代 码 中 Person 为 父 类 ，Man 是 继承 了 Person 的 子 类 。 所 以 即使 Man 的 定义 中 没有 
实现 任何 功能 ， 但 是 它 却 拥 有 从 Person 类 继承 来 的 属性 和 方法 。Man 的 调用 结果 如 下 。 


man = Man('macy') 
man.say() #=> my name is macy 


当然 还 可 以 在 子 类 中 添加 新 的 方法 ， 而 新 方法 也 只 能 在 子 类 中 被 使 用 ; 父 类 不 可 以 访问 
子 类 中 定义 的 任何 内 容 。 子 类 中 添加 新 方法 的 样 例如 下 。 


class Man (Person) : 


def say(self，name) : #=> 覆盖 父 类 方法 
print 'hello ', name 
def sex(self) : #=> 新 的 方法 


print 'I am man' 


上 面 的 代码 中 给 子 类 添加 了 两 个 方法 : 一 个 是 与 父 类 相同 的 方法 名 的 方法 ， 它 会 覆盖 父 
类 的 方法 ; 另 一 个 是 新 定义 的 一 个 方法 。 具 体 的 调用 效果 如 下 。 


man = Man('macy') 


man.say() #=> hello macy 
man.sex() #=> I am man 
2.3.3 ”模块 文件 


Python 中 模块 也 是 组 织 封装 代码 的 一 种 方式 。 从 层次 和 结构 上 来 看 ， 它 是 类 和 函数 的 超 
集 。 一 个 模块 其 实 就 是 一 个 Python 文件 ， 在 模块 内 可 以 包含 任意 的 Python 对 象 和 语句 ， 当 
然 也 包括 类 和 函数 。 

模块 的 作用 相当 于 把 更 大 粒度 的 功能 代码 封装 在 一 起 ， 即 提供 了 代码 的 组 织 方式 ， 也 提 
供 了 代码 的 流通 和 公用 方式 。 因 为 在 Python 中 除了 可 以 使 用 自己 定义 的 模块 ， 还 可 以 安装 和 
使 用 第 三 方 的 功能 模块 。 这 样 不 同人 编写 的 功能 模块 就 可 以 被 相互 使 用 ， 只 要 在 编写 代码 的 
时 候 引入 对 应 的 模块 即 可 。 例 如 ，Python 自 带 的 os 模块 的 使 用 方式 如 下 。 


import os 
print os .envViron 


从 上 述 代码 中 可 以 看 出 ， 引 入 模块 使 用 的 是 import 关键 字 ， 其 后 则 是 需要 导入 的 具体 模 
块 名 os ; 之 后 则 打印 出 os 模块 的 environ 属性 内 容 ， 该 语句 会 打印 出 当前 机 器 的 系统 环境 变 
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量 的 配置 信息 。 另 外 还 有 一 种 模块 的 导入 方式 : 


from os import environ 
print environ 


这 种 方式 只 导入 os 模块 的 environ 属性 ， 其 执行 结果 与 前 面 一 致 。 而 如 果 希 望 给 导入 的 
模块 /属性 添加 一 个 别名 的 话 ， 则 可 以 使 用 as 关键 字 ， 使 用 方式 如 下 。 


from os import environ as env 
print env 


有 了 模块 之 后 编写 代码 就 变 得 更 加 轻松 ， 很 多 通用 功能 都 可 以 直接 使 用 第 三 方 模块 ， 而 
不 需要 自己 编写 。 而 如 果 我 们 没有 找到 合适 的 第 三 方 模块 时 ， 也 可 以 自己 编写 一 个 模块 文 
件 。 下 面 就 是 一 个 普通 的 模块 文件 样 例 : 


#!/usr/bin/env Python 
# -*- coding: utf-8 -*- 


def foo(): 
print 'I am module test' 


if _name =='_ mian _'; 
foo () 


把 上 述 内 容 保存 到 名 为 foo.py 的 文件 中 ， 则 该 文件 就 是 一 个 Python 模块 文件 。 而 在 具 
体 需要 使 用 到 该 模块 时 ， 其 使 用 方法 与 sys 模块 一 样 ， 具 体 如 下 。 


import foo # 导入 foo 模块 
foo.foo() #=> I am module test 


注意 导入 该 模块 时 需要 确保 foo.py 文件 与 当前 代码 文件 处 于 同一 个 文件 夹 中 ; 或 者 
把 foo.py 文件 存放 到 sys.path 中 的 任意 目录 ; 或 者 设置 PYTHONPATH 系统 环境 变量 ， 并 把 
foo.py 文件 存放 在 任意 一 个 目录 中 。 


2.3.4 包 


在 模块 文件 之 上 ，Python 中 还 有 一 个 包 的 概念 。 包 在 形式 上 其 实 是 一 个 文件 夹 ， 而 与 
普通 文件 夹 的 区 别 在 于 ， 包 文件 夹 中 必须 包含 一 个 _init_.py 文件 。 这 个 文件 的 内 容 可 以 为 
空 ， 也 可 以 编写 相关 代码 。 

包 的 概念 就 是 把 文件 夹 模拟 成 模块 文件 ， 所 以 在 使 用 上 与 模块 基本 一 致 。 与 模块 不 同 的 
是 包 下 面 不 仅 可 以 包含 模块 ， 还 可 以 包含 子 包 ， 子 包 还 可 以 包含 模块 和 子 包 。 不 管 包 的 层次 
有 多 少 ， 调 用 时 都 必须 从 上 至 下 一 层 一 层 地 引用 。 下 面 是 一 个 包 的 示意 结构 。 


test 
Pack 


如 果 


impo 
foo. 
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:py 
age dir 

l= Sol hy 
|==: foo spy 


需要 在 test.py 文件 中 调用 foo.py 中 的 foo0 函数 ， 那 么 代码 的 引入 方式 如 下 。 


rt package dir.foo 
foo () 


2.4 基础 数据 结构 


学 习 
因为 相对 
工作 中 常 


Python 除了 要 学 习 基本 的 语法 之 外 ， 还 需要 学 习 的 就 是 它 的 数据 结构 和 内 置 函数 。 
于 其 他 语言 来 说 ，Python 的 数据 结构 与 内 置 函数 拥有 更 加 易 用 的 接口 和 功能 。 日 常 
见 的 数据 操作 和 功能 需求 ，Python 大 部 分 都 已 经 帮 有 我 们 实现 了 ， 我 们 所 要 做 的 就 是 


直接 调用 


。 而 这 也 正 是 Python 的 设计 哲学 。 


本 节 先 介绍 Python 中 的 常用 数据 结构 ， 主 要 有 列表 (list)、 元 组 (tuple)、 字 典 (map)、 


集合 (set 


2.4.1 


)。 


列表 


Python 中 的 列表 类 似 于 Java 中 的 动态 数组 ， 它 可 以 用 来 存储 一 组 对 象 ， 并 且 可 以 动态 


增加 和 删除 对 象 元 素 ， 通 过 下 标 来 访问 具体 的 对 象 。 与 Java 动态 数组 不 同 的 是 ，Python 的 列 
表 中 可 以 同时 存储 不 同类 型 的 对 象 ， 还 可 以 通过 切片 来 访问 对 象 元 素 。 

列表 的 定义 有 两 种 方式 : 一 对 中 括号 ，list 函数 。 具 体 定义 方式 如 下 。 

## 定义 空 列表 

业 要 时 

12 = list() 

13 = [1, 2, 3] # 纯 数字 的 列表 

14 = ['a', 'b', 'c'] # 纯 字符 串 的 列表 

15 = [1, 'a', True, None, 14] # 混合 列表 


列表 创建 之 后 可 以 通过 下 标 、 切 片 等 方式 来 访问 具体 元 素 。 具 体操 作 如 下 。 


二 [ly 六 37 人 

# 通过 下 标 访问 ， 下 标 从 0 开始 

1[0] ## 第 一 个 元 素 
1[3] # 第 四 个 元 素 

# 通过 切片 访问 ， 切 片 符号 是 冒号 : 

1[0:] # 
1[0:3] Ls 名 令 
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Llssl #[1, 2, 3] 

a | #[1, 2, 3] 
bl #[1, 2, 3, 4] 
# 指定 步 长 的 切片 访问 ,第 二 个 冒号 后 为 步 长 

LED #[1, 2, 3, 4] 
二 0252] #[1, 3] 


上 述 代码 中 通过 下 标 访问 元 素 的 操作 与 Java 一 样 ， 只 要 给 定 需要 访问 的 元 素 的 下 标 位 置 


即 可 。 而 通过 切片 来 访问 元 素 时 ， 则 变 得 非常 灵活 。 具 体 规则 如 下 。 


口 切片 符号 为 冒号 。 

口 冒号 前 为 起 始 切 片 位 置 下 标 ， 冒 号 后 为 结束 切片 位 置 下 标 。 

口 起 始 位 置 下 标 在 切片 范围 内 ， 结 束 位 置 下 标 不 在 切片 范围 内 。 

口 起 始 位 置 下 标 留 空 表示 从 第 一 位 开始 ， 结 束 位 置 下 标 留 空 表示 到 列表 结束 。 

口 下 标 为 负数 表示 从 列表 尾部 开始 计数 ，-1 为 最 后 一 个 元 素 下 标 ，-2 为 倒数 第 二 个 元 
素 下 标 ， 以 此 类 推 。 

口 有 两 个 冒号 时 ， 第 二 个 冒号 后 的 数字 表示 切片 的 步 长 ， 默 认为 1。 

Python 中 列表 的 修改 也 非常 方便 ， 可 以 对 列表 进行 的 修改 操作 有 : 追加 元 素 、 更 新 元 素 、 


删除 元 素 。 具 体 的 操作 代码 如 下 。 


素 ; 
方式 ; pop 方法 从 列表 尾部 删除 一 个 元 素 ，del 关键 字 可 以 删除 指定 的 元 素 ，remove 方法 用 
于 删除 指定 内 容 的 元 素 。 


1= [1, 2, 3, 4] 


# 列 中 追加 内 容 七 

1.append(5) #1 2 Br hn 人 
# 更 新 列表 内 容 

1[2] = 'b' flr 2 "Dry 二 
TA] = “a? PET WB SB 
# 删除 列表 指定 元 素 

1.pop() #[1, 2, 'b'] 

del 1[0] #[2, 'b'] 
1.remove (2) 亲生 本 

# 列表 的 连接 

二 和 

1.extend (12) #1 => ['b', 6, 7] 
13= [8 ,9] 

12 += 13 #12 => [6, 7, 8, 9] 


上 述 代码 中 基本 包含 列表 数据 更 新 的 常见 操作 方式 。append 方法 向 列表 尾部 追加 一 个 元 
extend 方法 、+ 运算 符 用 于 连接 两 个 列表 ; 更 新 既 可 以 通过 下 标 方式 ， 也 可 以 通过 切片 


2.4.2 元 组 


元 组 相当 于 Java 中 的 定 长 数组 ， 即 元 组 定义 之 后 其 内 容 、 长 度 是 不 可 修改 的 。 而 除了 内 
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容 不 可 修改 之 外 ， 元 组 的 其 他 操作 与 列表 基本 一 致 ， 可 以 认为 元 组 就 是 不 可 修改 的 列表 ， 所 
以 元 组 的 基本 操作 与 列表 很 相似 。 
元 组 的 定义 方式 也 有 两 种 : 圆 括号 ，tuple 函数 。 具 体 定义 方式 如 下 。 


t = tuple() # 定义 一 个 空 元 组 
tl = (1,) # 只 有 1 个 元 素 的 元 组 
t2 = (1, 2) # 包含 两 个 元 素 的 元 组 
1 = [3, True, None] 

t3 = tuple(1) # 把 列表 转 成 元 组 


空 元 组 只 能 通过 tuple 函数 创建 ; 并 且 使 用 圆 括号 创建 只 有 一 个 元 素 的 元 组 时 ， 需 要 在 
该 元 素 后 额外 添加 一 个 逗号 以 区 分 于 圆 括号 表达 式 。 另 外 ， 列 表 和 元 组 之 间 可 以 直接 转换 ， 
使 用 tuple 则 是 把 列表 转换 成 元 组 ， 而 使 用 list 则 可 以 把 元 组 转换 为 列表 。 

由 于 元 组 内 的 元 素 是 不 可 修改 的 ， 所 以 对 元 组 只 能 进行 读 取 的 操作 。 具 体操 作 示 例 
如 下 。 


t= (l, 2, 3 Truey None, ‘str') 

t[0] #1 

全 | #(1,2,3) 

t[3:] #(True, None, 'str') 

Ciel) #'str' 

CE #(1, 2, 3, True, None, 'str') 


可 以 看 到 元 组 读 取 元 素 的 操作 与 列表 基本 相同 ， 只 是 在 进行 切片 的 时 候 ， 返 回 的 是 子 元 
组 而 不 是 列表 。 


提示 有些 读者 可 能 会 疑惑 ， 既 然 元 组 可 以 做 到 的 事情 ， 列 表 都 可 以 完成 ， 并 且 还 可 以 
支持 修改 ， 那 么 为 什么 还 需要 元 组 呢 ? 其 实 正 是 因为 元 组 具有 不 可 修改 的 特性 ， 所 以 才 有 它 
存在 的 必要 性 ， 因 为 在 有 些 场景 下 就 是 不 希望 列表 中 的 数据 被 改动 ， 这 个 时 候 就 可 以 使 用 元 
组 了 。 


2.4.3 ”字典 


Python 中 的 字典 相当 于 Java 中 的 HashMap， 其 元 素 是 由 一 组 键 值 对 组 成 。 字 典 中 元 素 
的 键 不 能 重复 ， 而 不 同 键 对 应 的 值 是 可 以 重复 的 。Python 中 一 切 都 是 对 象 ， 所 以 字典 的 键 和 
值 都 可 以 支持 任意 类 型 。 

字典 的 定义 也 有 两 种 方式 : 大 括号 ，dict 函数 。 具 体 的 定义 方式 如 下 。 


d= 1{} # 空 字典 
dl = dict() # 空 字典 
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d2. 和 3 4 BF 5} 27 3 5} 
RT SD 

d3 = dict (1) 天 二 六 二 
t= ([l, None], [2, True]) 

d4 = dict(t) # => {1: None, 2: True} 


可 以 看 到 字典 除了 可 以 直接 定义 ， 还 可 以 通过 列表 或 元 组 进行 转换 。 在 定义 字典 的 时 候 
如 果 键 有 重复 ， 则 后 面 的 键 所 对 应 的 值 会 覆盖 前 面 键 的 值 。 例 如 ，d2 中 有 两 个 为 3 的 键 , 但 
只 有 后 面 键 的 值 生效 了 。 在 通过 列表 或 元 组 转换 时 ， 需 要 保证 其 子 元 素 都 是 一 个 长 度 为 2 的 
列表 或 元 组 。 

字典 的 读 取 方 式 是 通过 键 来 读 取 对 应 的 值 。 示 例如 下 。 


d= {1: 2, 'a': 'b', None: False} 


二] # => 2 

d[2] # => KeyError 
d.get('a') # 一 > 'b' 
d.get('c') # => None 
d.get('c', 0) # => 0 


可 以 看 到 字典 读 取 值 的 方式 有 两 种 : 通过 中 括号 和 get 方 法。 它们 需要 接收 一 个 键 然 
后 返回 对 应 的 值 。 需 要 注意 的 是 ， 通 过 中 括号 访问 字典 时 ， 如 果 给 定 的 键 不 存在 则 会 抛 出 
KeyError 异常 。 而 通过 get 方 法 访问 字典 时 ， 如 果 给 定 的 键 值 不 存在 则 默认 会 返回 None 值 ， 
并 且 还 可 以 指定 一 个 默认 值 。 

字典 是 可 以 动态 更 新 的 ， 并 且 也 需要 通过 键 值 对 匹配 的 方式 。 具 体 示 例如 下 。 


d= {1: 2, 'a': 'b', None: False} 
d[2] = 4 # 添加 元 素 

#{1: 2, 2: 4, 'a': 'b', None: False} 
关于 之 被 # 更 新 元 素 

#{1: 1, 2: 4, 'a': 'b', None: False} 
del d['a'] # 删除 元 素 


#{1: 1, 2: 4, None: False} 


字典 在 更 新 时 需要 先 通过 键 访问 到 值 元 素 ， 然 后 再 给 对 应 的 值 重新 赋值 。 当 访问 的 键 不 
存在 时 则 会 在 字典 中 新 建 一 个 键 并 赋值 ， 当 访问 的 键 存在 时 则 会 更 新 原来 的 值 。 同 样 在 删除 
元 素 时 也 需要 先 获取 到 键 对 应 的 值 元 素 。 


提示 因为 字典 键 的 不 重复 特性 ， 在 某 些 场景 下 还 可 以 用 来 进行 去 重 和 计数 。 而 如 果 希 
望 对 两 个 集合 进行 去 重 ， 则 需要 使 用 到 set。 
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2.4.4 ”遍历 数据 


前 面 介绍 了 Python 中 最 常用 的 三 种 数据 结构 : 列表 、 元 组 和 字典 。 除 了 前 面 介绍 的 操作 
方法 之 外 ， 还 有 一 种 比较 常见 的 数据 访问 方式 : 遍历 。 

遍历 就 是 把 对 象 中 的 所 有 成 员 都 从 头 到 尾 访问 一 遍 。 在 Python 中 遍历 对 象 最 常用 的 就 
是 for.in 组 合 。 不 同 数据 对 象 遍历 的 方式 如 下 。 


l= [l, 2 3¢ 4 5] 
For 4 in Ls 


print i 
t= ('a', 'b', 'c', 'd') 
for 法 dn ts 
print i 
d= {1: 'a', 'b': True, False: 'None'} 
for k in d: 
print d[k] 


for v in d.values () : 
print v 


for k, v in d.items () : 
print k, v 


上 述 代码 中 对 列表 和 元 组 的 遍历 很 容易 理解 ， 每 次 都 会 拿 到 一 个 子 元 素 ， 然 后 打印 出 
来 ， 直 到 结束 。 而 对 字典 而 言 其 遍历 方式 有 三 种 : 只 遍历 键 、 只 遍历 值 、 遍 历 键 和 值 。 默 
认 是 只 遍历 键 。 需 要 遍历 值 的 时 候 则 调用 values 方法 ， 需 要 同时 遍历 键 和 值 的 时 候 则 调用 
items 方法 。 


2.5 输入 /输出 
Python 中 基本 的 输入 /输出 包括 : 命令 行 输入 /输出 、 文 件 输入 /输出 。 


2.5.1 命令 行 输 入 /输出 

这 里 的 命令 行 输入 /输出 是 指 从 命令 行 获取 输入 ， 向 命令 行进 行 输 出 。 从 命令 行 获取 输 
人 有 两 个 内 建 的 函数 : input、raw_input。 它 们 都 可 以 用 来 从 命令 行 获取 用 户 的 输入 内 容 ， 而 
不 同 之 处 在 于 ， 从 raw_input 可 以 获取 用 户 的 原始 输入 ， 而 从 input 获取 到 的 则 是 经 过 处 理 的 
用 户 输入 。 下 面 是 这 两 个 函数 的 使 用 示例 。 


>> raw = raw_ input('input for raw input:') 
input for raw input: 123 
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>> raw 

>> 

>> inputl = input('input for input:') 
input for input: 123 

>> input1 

‘To 


上 述 代 码 中 两 个 函数 的 使 用 效果 是 一 样 的 ， 接 着 再 看 一 个 例子 。 


>> raw = raw_input('input for raw input:') 

input for raw input: test 

>> raw 

'test' 

>> 

>> input1l = input('input for input:') 

input for input: test 

Traceback (most recent call last): 
File "<stdin>", line 1, in <module> 
File "<string>", line 1, in <module> 

NameError: name 'test' is not defined 


这 次 只 有 raw_input 正常 返回 ， 而 input 则 直接 报错 ， 原 因 是 raw_input 把 用 户 的 任何 输 


入 都 当 作 字符 串 ， 而 input 则 把 用 户 的 任何 输入 都 当 作 Python 表达 式 。 所 以 raw_input 总 是 
以 字符 串 的 形式 返回 用 户 输入 ， 而 input 则 会 尝试 返回 用 户 输入 的 表达 式 的 执行 结果 。 再 来 
看 一 个 例子 。 


>> raw = raw_input('input for raw input:') 
input for raw input: 1 +2+3 
>> raw 


>> inputl = input('input for input:') 
于 PRPiit, fOr inputs 上 上 十 人 下 3 

>> input1l 

6 


这 次 可 以 更 清晰 地 看 到 两 个 函数 的 不 同 之 处 。raw_input 以 字符 串 的 形式 返回 原始 用 户 输 


入 ，input 返回 的 则 是 eval('1 + 2 + 30 的 结果 。 


可 以 从 命令 行 输入 ， 自 然 就 可 以 向 命令 行 输出 。 输 出 到 命令 行 可 以 使 用 print 语句 。 最 


出 名 的 Hello world 程序 输出 方式 如 下 。 


print 'Hello world' 


通过 print 可 以 打印 任何 想 打 印 的 内 容 ， 默 认 它 只 以 字符 串 的 形式 打印 对 象 ， 所 以 下 面 


这 两 个 语句 打印 出 的 内 容 是 一 样 的 。 


Print 6 各 一 > 和 
print '6' # => 6 
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另外 ， 如 果 希 望 打印 一 个 对 象 的 原生 字符 串 内 容 的 话 ， 可 以 使 用 repr 函数 。 具 体 效果 
如 下 。 


a = u' 中 国 ' 

print a # => 中 国 

print repr (a) # => u'\u4e2d\u56fd' 
print “a # => u'\u4e2d\u56fd' 


2.5.2 文件 输入 /输出 


这 里 的 文件 输入 /输出 是 指 从 文件 中 读 取 内 容 和 向 文件 写 入 内 容 。Python 中 读 写 文件 有 
两 种 方式 : open 函数 和 file 类 。 其 中 ，open 函数 本 身 就 是 调用 的 fle 类， 对 于 常规 的 文件 操 
作 ， 官方 推荐 使 用 open 函数 替代 file 类 。 

open 函数 同时 支持 读 写 文件 操作 ， 使 用 不 同 的 标识 表示 不 同 的 读 写 模式 。 

口 r: 表示 读 文 件 模式 。 

口 w: 表示 写 文件 模式 。 

口 a: 表示 追加 文件 模式 。 

口 b: 以 二 进 制 模式 读 写 文件 。 

口 +: 同时 支持 读 、 写 模式 。 

具体 的 使 用 方式 如 下 。 

# 读 方式 打开 文件 ， 文 件 不 存在 则 报错 

f = open('test.txt', 'r') 

# 写 方式 打开 文件 ， 文 件 不 存在 则 新 建 ， 文 件 存在 则 覆 写 原文 件 内容 

£f = open('test.txt', 'w') 

# 追加 方式 打开 文件 ， 文 件 不 存在 则 新 建 ， 文 件 存在 则 在 原 内 容 后 追加 新 内 容 

f = open('test.txt', 'a') 

# 读 方式 打开 文件 ， 既 支持 读 内 容 ， 也 支持 写 内容 。 文 件 不 存在 则 报错 

f = open('test.txt', 'r+') 

# 读 方式 打开 文件 ， 既 支持 读 内 容 ， 也 支持 写 内容 。 文 件 不 存在 则 新 建 

f = open('test.txt', 'w+') 

# 二 进 制 读 方式 打开 文件 ， 只 支持 读 内 容 ， 且 以 二 进 制 方式 读 取 ,文件 不 存在 则 报错 

f = open('test.txt', 'rb') 

通过 上 面 的 几 种 方式 打开 文件 后 ， 不 同 模式 可 以 支持 的 操作 不 同 。 以 读 模式 打开 文件 时 
只 能 执行 读 操作 ， 以 写 模式 打开 文件 时 只 能 执行 写 操作 ， 以 读 写 模式 打开 时 则 同时 可 以 执行 
读 写 操作 。 读 模式 时 文件 不 存在 则 会 报错 ， 写 、 追 加 模式 时 文件 不 存在 则 会 新 建 。 

通过 open 函数 打开 文件 后 ， 接 着 就 可 以 进行 相应 的 读 写 操作 了 。 读 内 容 时 可 以 使 用 
read 相关 方法 ， 如 read 、readline 、readlines。 写 内 容 时 可 以 使 用 write 相关 方法 ， 如 write、 
writelines。 具 体 的 操作 实例 如 下 。 
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f = open('test.txt', 'w') 
f.write('1\r\n') 
f.writelines(['3\r\n', '4\r\n']) 
f.close() 


上 述 代码 中 ，write 方法 接收 一 个 字符 串 参 数 ， 并 写 人 文件 ;writelines 则 接收 一 个 字符 
串 的 列表 参数 ， 并 把 列表 的 内 容 按 顺序 写 入 文件。 值得 注意 的 是 ， 这 两 个 方法 默认 都 不 会 主 
动 添加 换行 符 。 上 述 代码 执行 后 打开 文件 testtxt， 其 内 容 如 下 。 


学 
4 


读 取 该 文件 的 代码 样 例 如 下 。 

f = open('test.txt', 'r') 

print f.read() # 读 取 全 部 文件 内 容 
f.seek(0) # 返回 文件 开始 位 置 

print f.read(2) # 读 取 两 个 字 节 的 内 容 
f.seek(0) 

print f.readline() # 读 取 当 前 行内 容 

print f.readlines() # 读 取 当 前 和 之 后 的 所 有 行内 容 
f.close() 


上 述 代 码 中 ， 读 文件 内 容 有 多 种 形式 ， 可 以 根据 自己 的 需求 确定 使 用 哪 一 种 。 如 果 只 是 
遍历 文件 内 容 ， 优 先 选择 readline 方法 ， 因 为 在 读 取 大 文件 的 时 候 它 的 性 能 最 好 。 或 者 可 以 使 
用 for.in 来 遍历 文件 内 容 ， 每 遍历 一 次 相当 于 执行 一 次 readline 方法 。 遍 历 文件 的 代码 如 下 。 

with open('test.txt', 'r') as f: 


for line in f: 
print line 


这 里 除了 使 用 for.in 来 遍历 内 容 ， 还 使 用 with 关键 字 来 绑 定 上 下 文 环 境 ; 其 作用 是 无 论 
执行 遍历 过 程 中 是 否 成 功 ， 都 会 自动 关闭 文件 对 象 而 无 须 显 式 地 调用 close 方法 。 


2.6 内置 郴 数 


与 大 部 分 语言 一 样 ，Python 在 安装 完成 时 就 已 经 包含 很 多 的 内 置 模块 。 前 面 章节 介绍 过 
的 list、tuple、dict、open 等 都 属于 Python 的 内 置 函数 。 而 除了 这 些 函 数 之 外 ， 另 外 还 有 一 
些 内 置 函数 也 是 非常 好 用 的 。 本 节 先 介绍 一 些 比较 有 特点 的 内 置 函 数 。 
2.6.1 id 函数 

id 函数 用 于 查看 指定 对 象 的 内 存 地 址 引用 。 如 果 两 个 对 象 的 id 值 相 等 ， 那 么 这 两 个 对 象 
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的 内 存 地 址 相同 ， 即 为 同一 个 对 象 。 


a=b=4 

id(a) # => 22215852 

id(b) # => 22215852 
2.6.2 dir 函数 


dir 函数 用 于 查看 指定 对 象 的 成 员 和 属性 。 这 个 函数 在 调试 和 学 习 第 三 方 模块 时 非常 好 
用 。 对 于 一 个 不 清楚 的 对 象 ， 只 要 使 用 dir 函数 查看 下 ， 就 知道 它 有 哪些 属性 和 方法 。 


二 人 
dir(s) 


这 段 代码 执行 后 打印 的 是 字符 串 对 象 所 包含 的 成 员 和 属性 ， 具 体 如 图 2-8 所 示 。 


图 2-8 对 象 dir 信息 
而 如 果 你 希望 查看 Python 包含 哪些 内 置 的 函数 和 对 象 ， 则 可 以 使 用 如 下 代码 。 
dir(_builtins ) 
2.6.3 ”help 函数 
当 通 过 dir 函数 查看 某 些 对 象 或 属性 时 ， 可 能 更 希望 查看 它 的 帮助 文档 。 此 时 就 可 以 使 
用 help 函数 。 例 如 ， 查 看 dir 函数 的 帮助 文档 ， 其 命令 如 下 。 
help (dir) 


具体 执行 效果 如 图 2-9 所 示 。 


图 2-9 查看 dir 函数 的 帮助 文档 


72 


六 Python Web 自动 化 测试 设计 与 实现 


2.6.4 type 函数 


type 函数 用 于 查看 指定 对 象 的 类 型 。 虽 然 Python 中 所 有 对 象 的 最 终 父 类 都 是 Object， 但 
是 Object 下 还 是 会 有 很 多 的 子 类 型 。 使 用 type 函数 则 可 以 查看 具体 属于 哪个 子 类 型 。 


type (1) #=> <type 
type('') #=> <type 
type (True) #=> <type 
type (None) #=> <type 
type ([]) #=> <type 
type((1,)) #=> <type 
type({}) #=> <type 


2.6.5 isinstance 函数 


通过 id 函数 可 以 比较 两 个 对 象 是 否 相同 ， 通 过 type 函数 可 以 比较 两 个 对 象 类 型 是 否 一 
致 。 而 通过 isinstance 函数 则 可 以 查看 一 个 对 象 是 否 是 另 一 个 对 象 的 实例 。 具 体 使 用 方式 如 下 。 


isinstance(1，int) 
isinstance (1，Stzr) 


ae 
"mr 
'bool'> 
'None'> 
'list'> 
"tuple'> 
'dict'> 


isinstance (1， (str, int)) 


isinstance (1, object) 


# => True 
# => False 
# => True 
# => True 


从 执行 结果 来 看 ，isinstance 函数 不 仅 可 以 通过 实例 对 象 本 身 的 类 型 来 判断 ， 还 可 以 通过 
实例 对 象 类 型 的 父 类 型 进行 判断 。 另 外 ， 可 以 支持 同时 查询 多 个 类 型 ， 只 要 匹配 任意 一 个 则 
返回 True。 


2.6.6 zip 函数 
zip 函数 可 以 理解 为 具有 合并 功能 的 函数 。 它 可 以 接收 六 个 参数 ， 每 一 个 参数 都 必须 是 
可 以 迭代 的 序列 对 象 。 最 后 它 会 返回 经 过 合并 后 的 一 个 大 的 序列 ， 该 序列 的 子 元 素 会 包含 所 
有 参数 序列 的 对 应 位 置 上 的 元 素 。 具 体 使 用 效果 如 下 。 


lL =» (LeRl 
12 = [4;5,6] 
13 = [7,8,9] 


zip(11,12,13) #=> [{(1, 4, 7), 


(2, 5, 8), (3, 6, 9)] 


可 以 看 到 zip 函数 会 把 每 个 参数 对 应 位 置 上 的 元 素 进行 合并 ， 并 作为 返回 序列 的 对 应 子 
元 素 。 需 要 注意 的 是 ， 如 果 传人 参数 的 长 度 不 一 致 ， 则 默认 以 最 短 的 参数 长 度 为 准 。 


2.6.7 filter 函数 
filter 函数 字面 上 理解 为 具有 过 滤 功 能 的 函数 。 它 会 对 给 定 的 序列 参数 进行 特定 条 件 的 过 
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滤 ， 并 且 可 以 定义 过 滤 条 件 的 函数 。 具 体 使 用 效果 如 下 。 


1 = [1,2,3,4,5,6,7,8,9,10] 

filter(lambda x: x % 2 == 0, 1) 

tm [2s & 6 8 10] 

上 面 的 filter 函数 对 列表 1 进行 了 过 滤 ， 过 滤 条 件 则 是 可 以 被 2 整除 ， 所 以 返回 的 结果 中 
都 是 偶数 。 


2.6.8 map 函数 


map 函数 可 以 理解 为 具有 了 映射 功能 的 函数 。 它 会 把 参数 序列 中 的 每 一 个 元 素 都 映射 给 指 
定 函 数 ， 最 后 返回 所 有 执行 结果 的 列表 。 具 体 效 果 如 下 。 


1= [1,2,3,4,5,6,7,8,9,10] 
map(lambda x: x * x, 1) 
¥ sy blr 4 9 "6, 25. 6, 249. Sr 8 3200] 


上 面 的 map 作用 是 把 列表 1 中 的 元 素 依次 传递 给 指定 函数 执行 ， 并 保存 了 每 一 次 的 执行 
结果 。 


2.6.9 ”reduce 函数 


reduce 函数 可 以 理解 为 具有 聚合 功能 的 函数 。 它 会 把 参数 序列 按照 指定 的 方式 进行 聚 
合 ， 并 返回 最 后 的 聚合 结果 。 具 体 效 果 如 下 。 


1 = [1,2,3,4,5] 
reduce (lambda x, y: x * y, 1) # => 120 


上 述 代码 实现 了 一 个 阶乘 为 5 的 算术 功能 。reduce 函数 第 一 次 会 取出 前 两 位 元 素 ， 并 传 
递 给 参数 函数 ; 在 计算 完成 之 后 取 回 结果 ， 最 后 再 把 这 个 结果 与 序列 参数 中 的 下 一 个 元 素 一 
并 传 给 参数 函数 ， 直 到 参数 序列 执行 结束 。 


2.7 异常 


异常 指 的 是 程序 在 执行 过 程 中 发 生 的 错误 。 这 些 错误 可 能 是 预期 的 ， 也 可 能 是 非 预期 
的 。 对 于 那些 可 以 预期 的 异常 ， 应 该 在 代码 中 进行 捕获 并 做 相应 处 理 。 


2.7.1 异常 捕获 


Python 中 捕获 异常 使 用 try…except 语句。 对 于 预期 可 能 会 发 生 异 常 的 代码 ， 需 要 放 到 
try 语句 块 ， 而 当 异 常 被 捕获 后 进行 处 理 的 代码 ， 则 需要 放 到 except 语句 块 。 
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首先 看 下 异常 代码 不 进行 捕获 时 ， 其 执行 的 效果 。 


图 2-10 除 零 异常 
接着 ,对 于 异常 代码 进行 捕获 ， 更 新 后 的 代码 如 下 。 


try: 
n=1/0 
except: 
pass 


这 上段 代码 中 的 try 语句 块 会 捕获 到 除 零 异 常 ， 之 后 将 直接 执行 except 语句 块 的 代码 。 这 
里 选择 不 对 异常 做 任何 响应 处 理 。 

上 面 使 用 except 可 以 捕获 所 有 类 型 的 异常 ， 而 如 果 和 希望 对 特定 的 异常 进行 捕获 ， 则 可 以 
指定 一 个 异常 类 型 。 例 如 ， 只 捕获 除 零 异常 ， 则 代码 可 以 更 新 如 下 。 


try: 
n=1/0 

except ZeroDivisionError: 
print 'i am in except' 


这 段 代码 只 捕获 除 零 异常 ， 而 对 于 其 他 原因 引发 的 异常 仍然 会 被 抛 出 。 此 外 ，Python 的 
异常 捕获 语句 还 支持 else 语句 ， 它 与 except 语句 的 逻辑 相反 ， 即 当 try 语句 块 无 异常 触发 时 
会 被 执行 。 其 使 用 方式 如 下 。 

try: 

n=0/1 

except ZeroDivisionError: 

print 'i am in except' 
else: 
print 'i am in else' 


这 段 代 码 中 没有 除 零 异 常 ， 所 以 它 的 执行 结果 如 下 。 


i am in else 
在 另外 一 些 场景 中 ,不论 try 语句 块 中 是 否 触发 异常 ， 我 们 都 希望 执行 一 些 清 理 代码 ， 
例如 ， 关 闭 文件 、 关 闭 数据 库 连 接 。 这 时 就 需要 使 用 到 finally 语句 。 其 使 用 方式 如 下 。 


try: 
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except: 

print 'i am in except' 
else: 

print 'i am in else' 
finally: 

print 'i am in finally' 


在 这 段 代码 中 ， 不论 try 语句 块 是 否 有 异常 ，finally 语句 块 中 的 代码 都 会 被 执行 ， 而 
except 语句 块 只 有 发 生 异常 时 才 会 执行 ，else 语句 块 则 在 无 异常 发 生 时 执行 。 
需要 注意 的 是 ， 在 进入 到 try 语句 块 之 后 ，finally 语句 块 的 代码 在 任何 情况 下 都 会 被 执 
行 。 即 使 在 try 语句 块 中 执行 了 return， 并 且 如 果 finally 语句 块 也 有 returm， 则 finally 语句 块 
的 return 语句 会 覆盖 try 语句 块 的 return。 
def foo(): 
try: 
do something… 
return 1 
except: 
return 2 
else: 
return 3 
finally: 
return 4 


上 述 代 码 中 无 论 try 语句 块 的 执行 结果 如 何 ， 最 终 返回 的 结果 始终 是 4。 


2.7.2 自 定 义 异常 


前 面 介绍 的 是 如 何 捕 获 运行 时 异常 ， 这 些 异常 都 是 系统 或 者 第 三 方 模块 抛 出 的 异常 。 除 
此 之 外 ， 还 可 以 自 定义 异常 并 在 合适 的 场景 中 抛 出 。 最 简单 的 自 定义 异常 如 下 。 


class MyException (Exception) : 
pass 


可 以 看 到 实现 一 个 自 定义 异常 是 如 此 简单 ， 只 要 继承 一 个 Exception 父 类 即 可 。 或 者 也 
可 以 继承 自 其 他 的 已 定义 异常 ， 而 Exception 异常 则 是 所 有 异常 的 基 类 。 该 自 定义 异常 的 使 
用 方式 如 下 。 
try: 
raise MyException() 


except MyException, e: 
print e 


通过 raise 语句 可 以 抛 出 一 个 异常 对 象 ， 这 里 抛 出 的 就 是 自 定义 异常 MyException。 也 可 
以 抛 出 其 他 的 已 知 异常 ， 例 如 ，raise Exception() 就 是 抛 出 一 个 通用 异常 。 
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当然 也 可 以 给 自 定义 异常 类 添加 任意 的 成 员 变 量 ， 就 像 普 通 类 对 象 一 样 ， 如 下 所 示 。 


class MyException (Exception): 
def _ init (self, *args, **kargs): 
self.args = args 
self.kargs = kargs 


def _str__(self): 
return 'args: %s\r\nkargs: %s' % (self.args, self.kargs) 


这 次 我 们 给 自 定义 异常 添加 了 初始 化 参数 ， 并 在 打印 回 显 的 时 候 返回 接收 到 的 参数 。 其 
具体 的 使 用 方式 如 下 。 


try: 


raise MyException(1,2,custom=True) 
except MyException, e: 


print e 
这 段 代码 执行 后 的 效果 如 下 。 
args: (1, 2) 
kargs: {'custom': True} 


提示 根据 异常 的 特性 ， 在 某 些 情况 下 我 们 可 以 通过 异常 来 传递 数据 参数 ， 从 而 替代 
return 所 不 能 覆盖 的 场景 。 


2.8 魔法 特性 
Python 作为 动态 语言 ， 有 很 多 语言 自身 的 特性 。 这 些 特性 不 仅 可 以 实现 某 些 特定 的 功 
能 ， 并且 在 性 能 、 易 用 性 方面 也 是 比较 良好 的 。 本 节 则 会 介绍 一 些 比较 常用 的 Python 特性 。 


2.8.1 列表 推导 式 
列表 推导 式 又 称 为 列表 解析 表达 式 。 它 可 以 用 来 帮助 我 们 生成 一 个 目标 列表 对 象 ， 而 列 
表 中 的 元 素 可 以 通过 表达 式 来 生成 。 列 表 推导 式 的 语法 结构 如 下 。 


[5 toz ee dn “ee [it 1]] 
下 面 是 一 个 简单 的 例子 。 
1= [i* i for i in range(5)] 


可 以 看 到 列表 推导 式 使 用 中 括号 作为 包含 符号 ， 中 括号 内 的 表达 式 则 是 生成 列表 的 条 
件 。 上 面 的 代码 中 表达 式 的 条 件 是 : 对 range(5) 中 的 每 一 个 数 都 进行 平方 计算 。 其 功能 等 同 


第 2 章 Python 编程 基础 & 77 


于 下 面 的 代码 。 


def foo() : 
| 
for i in range(5) 
l.append(i * i) 
return 1 
1 = foo() 


所 以 最 后 得 到 的 列表 内 容 如 下 。 

【2 江 关 十 7 1 

此 外 ， 还 可 以 对 原始 数据 进行 条 件 过 滤 。 例 如 ， 只 对 1 ~ 10 之 间 的 偶数 进行 平方 计算 。 
其 代码 内 容 如 下 。 

有 二 [时 性 二 or 二 i angelly 1 :i 2 m0] 

此 时 返回 列表 的 内 容 如 下 。 

tar 6 S65 4 100] 

现在 我 们 可 以 回想 一 下 ， 其 实 之 前 介绍 的 filter 函数 ， 完 全 可 以 使 用 列表 推导 式 来 实现 
其 功能 。 


2.8.2 ”人 迭代 器 

首先 来 了 解 下 迭代 是 什么 。 和 迭代 是 指 对 象 遍历 的 过 程 。 例 如 ， 前 面 介 绍 过 的 for.in 语句 
其 实 执行 的 就 是 迭代 。 之 所 以 列表 、 元 组 、 字 典 、 字 符 串 等 对 象 都 可 以 通过 for.in 语句 来 迭 
代 ， 是 因为 它 都 是 可 迭代 的 对 象 。 

任意 实现 _iter “方法 的 对 象 都 是 可 迭代 对 象 。_iter ”方法 需要 返回 一 个 欠 代 器 。 通 
过 dir 函数 可 以 查看 列表 、 元 组 等 对 象 都 包含 _iter_ 方 法， 如 图 2-11 所 示 。 


图 2-11 和 迭代 器 魔法 属性 


可 迁 代 对 象 在 执行 欠 代 时 会 被 传递 给 内 建 的 iter 函数 ， 该 函数 会 调用 可 迭代 对 象 的 
iter “方法 ， 从 而 获取 到 一 个 迭代 器 对 象 。 

任意 实现 _iter 和 next 方法 的 对 象 都 是 迭代 器 对 象 。 和 迭代 器 的 _iter “方法 返回 自 
身 ，next 方 法 则 返回 对 象 容器 中 的 下 一 个 值 。 当 对 象 中 的 值 都 迭代 完 之 后 ，next 方法 会 抛 出 
StopIteration 异常 。 
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下 面 的 一 组 命令 演示 了 列表 从 一 个 可 迭代 对 象 ， 到 迭代 器 ， 再 通过 next 进行 迭代 的 
过 程 。 


[1, 2] 


1 

i = iter(1) # 并 为 迄 代 器 对 象 

i.next() # => 1 

i.next() # => 2 

i.next() # StopIteration 
2.8.3 ”生成 器 


生成 器 的 功能 与 迭代 器 差不多 ,但 在 实现 方式 和 功能 上 更 加 友好 。 在 实现 上 生成 器 对 象 
不 需要 实现 _iter _ 和 next 方 法 。 此 外 ， 生 成 器 是 一 种 懒 计算 模 式 的 迭代 器 ， 它 会 在 需要 使 
用 具体 值 的 时 候 才 去 生成 ， 而 迭代 器 则 会 一 次 性 把 所 有 值 提前 计算 好 。 

如 果 以 遍历 文件 来 举例 的 话 ， 和 迭代 器 会 提前 把 文件 的 内 容 一 次 性 加 载 到 内 存 ， 之 后 再 顺 
序 遍 历 ; 而 生成 器 则 会 在 遍历 过 程 中 单独 读 取 某 一 行 的 数据 到 内 存 。 

Python 中 实现 生成 器 的 方式 有 两 种 : 包含 yield 关键 字 的 函数 ， 生 成 器 表达 式 。 首 先 来 
看 下 yield 关键 字 的 实现 版 本 。 


def foo() : 
for i in range(5) : 
yield i * i 


执行 foo 函数 时 ， 返 回 的 就 是 一 个 生成 器 对 象 。 在 没有 以 任何 形式 执行 next 方 法 之 
前 ， 该 函数 不 会 执行 任何 内 部 代码 。 直 到 调用 next 方 法 时 ， 代 码 将 会 直接 执行 到 yield 所 
在 行 ， 并 返回 yield 关键 字 之 后 的 表达 式 结果 ， 之 后 将 继续 暂停 代码 执行 ， 直 到 下 一 次 调用 
next 方法 。 

生成 器 的 使 用 方法 与 迭代 器 一 样 ， 上 面 foo 函数 返回 的 生成 器 对 象 ， 使 用 方式 如 下 。 


f = foo() 
for i in fx 
Print 注 ， # 不 换行 打印 

# =>014916 

另 一 种 实现 生成 器 的 方法 是 使 用 生成 器 推导 式 ， 它 与 列表 推导 式 在 结构 上 很 相似 ， 只 是 
它 返回 的 不 是 列表 ， 而 是 生成 器 。 具 体 代码 如 下 。 

f= (i*1i for i in range(5)) 

可 以 看 到 生成 器 推导 式 使 用 圆 括号 作为 包含 符 ， 括 号 内 的 表达 式 则 是 生成 器 元 素 的 限 
制 条 件 。 上 面 这 一 行 代码 的 功能 等 同 于 之 前 foo 函数 的 定义 与 调用 。 这 就 是 Python 的 魔法 
特性 。 
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提示 在 任何 可 以 使 用 推导 式 的 场景 下 ， 应 尽量 使 用 推导 式 来 替代 其 他 实现 方式 ， 包 括 
列表 推导 式 和 生成 器 推导 式 。 使 用 推导 式 的 好 处 除了 可 以 简洁 代码 ， 在 性 能 上 也 会 优 于 其 他 
实现 方式 。 


2.8.4 闭 包 

闭 包 在 很 多 的 动态 语言 里 都 被 支持 。 它 是 一 个 引用 了 自由 变量 的 函数 ， 这 个 函数 引用 
的 自由 变量 会 和 函数 一 起 存在 ， 即 使 离开 了 自由 变量 原来 的 环境 。Python 中 实现 闭 包 的 条 
件 如 下 。 


口 闭 包 函数 必须 有 内 舱 函 数 。 
口 内 蔡 函 数 需 要 引用 该 符 套 函数 上 一 级 namespace 中 的 变量 。 
口 闭 包 函数 必须 返回 内 嵌 函 数 。 
一 个 简单 的 闭 包 例 子 如 下 。 
def fo0(): # 闭 包 函数 
m= 2 # 被 引用 的 自由 变量 
def bar (x) : # 内 嵌 函 数 
returnm*x 
return bar # 返回 内 嵌 函 数 


上 述 代 码 同 时 满足 了 闭 包 的 三 个 条 件 ， 所 以 它 是 一 个 正确 的 闭 包 函数 。 闭 包 函 数 的 使 用 
方式 如 下 。 


dub = foo() # 获取 内 嵌 函 数 
dub (4) # => 8 
dub (5) # => 10 


首先 ， 调 用 闭 包 函 数 获取 到 内 贬 函 数 对 象 ， 之 后 调用 内 肉 函 数 。 正 常情 况 下 一 个 函数 在 
返回 之 后 ， 其 局 部 变量 都 会 被 收回 。 而 这 里 的 foo 函数 在 返回 之 后 ，bar 函数 却 仍然 可 以 访问 
foo 函数 的 局 部 变量 ， 这 就 是 闭 包 的 功能 。 

闭 包 函数 之 所 以 能 从 函数 外 部 访问 函数 内 部 的 变量 ， 是 因为 闭 包 函数 给 返回 的 内 嵌 函 数 
添加 了 __closure “属性 。_closure “属性 中 存放 了 内 徐 函 数 所 引用 的 自由 变量 内 容 ， 并 保 
存在 cell 对 象 中 。 通 过 如 下 代码 可 以 打印 出 引用 的 变量 内 容 。 

dub.__closure [0] .cel1_contents # 第 一 个 被 引用 的 变量 内 容 


2.8.5 ”装饰 器 


装饰 器 顾名思义 ， 就 是 装饰 某 个 对 象 的 东西 ; 在 Python 里 装饰 器 则 是 装饰 函数 的 对 象 。 
这 个 对 象 可 以 是 另 一 个 函数 ， 也 可 以 是 一 个 callable 的 类 实例 。 装 饰 器 的 功能 就 是 给 被 装饰 


80 及 Python Web 自动 化 测试 设计 与 实现 


的 函数 添加 某 些 特定 的 功能 ， 从 而 达到 装饰 的 作用 。 


1. 函数 装饰 器 

在 Python 中 装饰 器 的 实现 是 接收 一 个 函数 作为 参数 ， 同 时 需要 返回 一 个 函数 作为 结果 。 
虽然 没有 明确 限定 返回 函数 和 传人 函数 需要 有 一 定 的 关联 ， 但 通常 情况 下 这 个 返回 函数 就 是 
被 装饰 过 的 传人 函数 。 这 样 才 有 装饰 的 概念 ， 最 简单 的 一 个 装饰 器 如 下 。 


def foo (func) : 
return func 


这 个 装饰 器 foo 接收 了 一 个 函数 作为 参数 ， 然 后 直接 返回 了 这 个 函数 作为 结果 。 它 满足 
了 上 述 对 装饰 器 的 要 求 ， 但 却 是 一 个 没有 做 任何 装饰 功能 的 装饰 器 。 为 了 让 装饰 器 具有 一 定 
的 功能 ， 那 么 就 需要 对 传人 的 函数 进行 封装 ， 如 下 所 示 。 
def foo(func) : 
def warp(): 
print '%s is working' % func. name 


return func() 
return warp 


这 次 我 们 添加 一 个 warp 内 部 函数 ， 它 用 来 装饰 传人 函数 ， 并 且 最 后 替代 了 传 入 函数 成 
为 返回 结果 。 这 里 就 开始 有 了 装饰 器 的 意义 ， 传 人 一 个 func 函数 ， 返 回 一 个 包装 了 func 函 
数 的 warp 函数 ， 即 得 到 的 是 一 个 装饰 过 的 func 函数 。 

上 面 装饰 器 的 作用 仅仅 是 打印 被 装饰 函数 的 名 称 ， 该 装饰 器 的 具体 使 用 和 效果 如 下 。 


efoo # 使 用 foo 装饰 器 
def test(): # 被 装饰 的 函数 
print 'hello Python' 


可 以 看 到 装饰 器 的 使 用 是 通过 @ 符号 来 表示 ， 其 后 跟 装 饰 器 的 名 称 ， 并 放置 在 被 装饰 
函数 的 定义 上 部 。 这 段 代码 执行 后 的 打印 结果 如 下 。 


test is working 
hello python 


其 中 ， 第 一 条 内 容 就 是 装饰 器 函数 所 打印 的 ， 而 第 二 条 则 是 test 函数 自己 内 部 打印 的 代 
码 。 所 以 这 个 foo 装饰 器 的 作用 就 是 打印 被 装饰 函数 的 名 称 。 

装饰 器 还 可 以 装饰 带 参 数 的 函数 ， 具 体 而 言 就 是 给 装饰 函数 添加 对 应 的 参数 即 可 。 假 设 
有 一 个 需要 被 装饰 的 函数 如 下 。 


def power (x): 
Teturn 其 二 其 


则 其 对 应 的 装饰 器 需要 定义 为 如 下 形式 。 
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def foo (func) : 
def warp (x) : 
Print '%s is working' % func. name _ 
return func (x) 
return warp 


这 里 可 以 看 到 ， 只 要 给 warp 函数 添加 对 应 的 函数 参数 即 可 。 而 为 了 保证 装饰 器 的 通用 
性 ， 通 常 需要 在 定义 装饰 器 时 直接 定义 动态 参数 来 兼容 不 同 参数 形式 的 函数 ， 如 下 所 示 。 
def foo (func) : 
def warp(*args, **kargs): 
Print '%s is working' % func. name __ 


return func(*args, **kargs) 
return warp 


除 此 之 外 ， 装 饰 器 本 身 也 可 以 具有 参数 ， 其 作用 是 让 装饰 器 本 身 更 加 通用 。 例 如 ， 现 在 
需要 一 个 2 倍 乘法 装饰 器 dub， 它 可 以 把 被 装饰 函数 的 返回 值 乘 以 2 倍 。 代 码 如 下 。 
def dub (func) : 
def warp (*args， **kargs): 


return func(*args, **kargs) * 2 
return warp 


使 用 该 装饰 器 的 使 用 效果 如 下 。 


@dub 
def val(): 
return 3 
print val() # => 6 


因为 val 函数 固定 返回 的 值 为 3， 所 以 经 过 dub 装饰 器 装饰 之 后 ， 返 回 的 结果 就 变 成 了 
6。 而 此 时 如 果 还 需要 一 个 3 倍 、4 倍 甚至 5 倍 的 装饰 器 ， 那 该 怎么 办 呢 ? 最 简单 的 方式 是 继 
续 编 写 若干 个 新 的 装饰 器 。 此 外 就 是 给 装饰 器 添加 一 个 参数 ， 这 个 参数 可 以 动态 指定 乘 以 的 
倍数 ， 这 样 只 需 一 个 装饰 器 就 可 以 实现 乘 以 任意 倍数 的 功能 。 修 改 之 后 装饰 器 代码 如 下 。 


def multiply(n) : 
def foo (func) : 
def warp(*args, **kargs): 
return func(*args, **kargs) * n 
return warp 
return foo 


这 里 在 原装 饰 器 外 面 添加 了 一 个 multiply 函数 封装 ， 这 个 函数 会 返回 foo 装饰 器 ， 所 以 
最 后 起 到 装饰 器 作用 的 依然 是 foo 函数 。 而 multiply 的 作用 仅仅 是 提前 传人 一 个 乘 以 倍数 的 
参数 n。 这 个 新 装饰 器 的 使 用 方式 如 下 。 
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emultiply(3) # 使 用 装饰 器 
def val() : 

return 3 
print val() # => 9 


上 述 代码 执行 的 结果 是 9， 如 果 把 装饰 器 参数 修改 为 @multiply(4)， 则 打印 的 结果 为 


4x3=12。 这 样 就 实现 了 一 个 支持 任意 倍数 的 装饰 器 了 。 


上 面 介 绍 的 装饰 器 在 大 多 数 情况 下 都 会 正常 工作 ， 而 在 某 些 特定 的 使 用 场景 下 则 会 发 生 


问题 。 例 如 ， 当 我 们 需要 打印 被 装饰 函数 的 函数 名 时 ， 可 能 就 会 出 现 问题 。 具 体 演示 如 下 。 


def test (x): 
return x 
print test. name__ 


上 述 代 码 打印 的 结果 为 :test。 下 面 为 其 添加 一 个 装饰 器 ， 再 进行 函数 名 的 打印 。 代 码 


如 下 。 


def foo (func) : 
def warp(*args, **kargs): 
return func(*args, **kargs) 
return warp 


@foo 
def test (x): 
return x 
print test. name__ 


上 述 代 码 打印 的 结果 为 : warp。 因 为 实际 返回 的 是 模仿 test 的 warp 函数 ， 而 并 非 真 正 


的 test 函数 。 为 了 让 装饰 器 能 比较 逼真 地 模仿 被 装饰 的 函数 ，Python 中 提供 了 warps 装饰 来 
解决 这 个 小 问题 。 使 用 效果 如 下 。 


from functools import wraps 


def foo (func) : 
@wraps (func) 
def warp(*args, **kargs): 
return func(*args, **kargs) 
return warp 


efoo 
def test (x) : 
return x 
print dutestb. name __ 


这 次 执行 的 打印 结果 为 : test。functools.warps 装饰 器 所 做 的 事情 就 是 把 传人 参数 func 


的 名 称 取 出 并 赋值 给 了 warp 函数 的 _name _ 而 已 。 
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提示 从 函数 装饰 器 的 定义 中 可 以 看 出 ， 其 具体 是 通过 闭 包 来 实现 的 。 而 装饰 器 也 是 闭 
包 在 Python 中 的 最 突出 的 应 用 。 


2. 类 装饰 器 

在 Python 中 所 有 的 数据 类 型 都 是 对 象 ， 函 数 自然 也 不 例外 ， 因 此 我 们 就 可 以 通过 类 的 
方式 来 实现 一 个 函数 对 象 。 在 Python 中 想 要 模拟 函数 对 象 只 要 实现 _call “方法 即 可 。 例 
如 ， 有 一 个 函数 装饰 器 如 下 。 


def foo (func) : 
def warp(): 
print func._ name __ 
return func () 
return warp 


其 功能 是 打印 被 装饰 函数 的 名 称 ， 则 其 对 应 的 类 装饰 器 实现 方式 如 下 。 


class Foo (object) : 
def _ init__ (self) : 
Pass 


def _call_ (self, func): 
def warp(): 
print func._ name__ 
return func () 
return warp 


当 一 个 类 具有 __call _ 方法 之 后 ， 那 么 它 的 实例 就 是 一 个 可 调用 对 象 。 我 们 就 可 以 像 使 
用 函数 一 样 使 用 这 个 对 象 ， 并 且 调用 的 具体 功能 就 是 _ call _ 方法 的 代码 。 对 于 这 样 一 个 类 
装饰 器 ， 其 使 用 方法 如 下 。 

Q@Foo () 


def bar() : 
pass 


bar() # => ba 


这 里 可 以 看 到 使 用 的 是 Foo 类 的 实例 作为 装饰 器 ， 这 段 代码 最 后 打印 的 内 容 为 : bar。 


2.8.6 ”内 省 机 制 

Python 中 一 个 非常 棒 的 方面 就 是 它 的 内 省 机 制 。 内 省 支持 我 们 在 程序 执行 过 程 中 ， 动 态 
地 查询 、 获 取 和 访问 特定 的 对 象 属性 。 这 个 机 制 在 某 些 场景 是 非常 有 用 的 ， 例 如 ， 管 理 系统 
插件 模块 的 热 拔 插 ， 有 了 内 省 的 支持 在 添加 删除 插件 的 时 候 ， 甚 至 都 不 需要 重启 / 重 载 程序 。 
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Python 中 提供 了 很 多 支持 内 省 的 内 建 函 数 、 属 性 和 模块 ， 这 里 只 介绍 一 些 比 较 常用 的 函 


数 和 属性 方法 。 具 体 罗列 如 下 。 


口 hasattr: 判断 对 象 是 否 具有 特定 的 成 员 。 

口 getattr: 从 对 象 中 获取 特定 的 成 员 。 

口 setattr: 给 对 象 设置 特定 的 成 员 。 

口 _file _: 获取 对 象 字 节 码 文件 所 在 路 径 。 

口 _name _: 获取 当前 模块 的 名 称 。 

口 _module_: 获取 实例 对 象 所 属 的 模块 名 。 

口 inspect: Python 内 省 库 。 

有 了 上 面 的 简单 说 明 ， 接 着 再 通过 样 例 代 码 演示 ， 就 可 以 很 容易 地 理解 并 学 会 如 何 使 用 


Python 的 常用 内 省 功能 。 首 先 来 看 下 *attr 相关 的 函数 使 用 方法 ， 具 体 如 下 。 


# -- coding: utf-8 -- 


class Foo (object) : 


name = 'macy'" 


def say_name (self): 
print 'my name is %s' % Foo.name 


print dir(Foo) #show all attrs of Foo 
print hasattr (Foo, 'name') # => True 
print hasattr (Foo, 'say name') # => True 
print hasattr(Foo, '_ init __') # => True 
print getattr (Foo, 'name') # => macy 


Say_name ref = getattr (Foo， 'say_name') 

Print say name ref # => <unbound method Foo.say name> 
foo = Foo!() 

say_name_ref (foo) # => my name is macy 


setattr (foo, 'age', 23) 
print hasattr (foo, "age') # => True 
print getattr (foo, 'age') # => 23 


通过 这 段 代 码 可 以 知道 ，*attr 函数 就 是 专门 用 来 维护 对 象 属性 的 一 组 工具 。 通 过 hasattr 


查询 属性 、getattr 获取 属性 、setattr 设置 属性 。 


在 Python 中 以 双 下 画 线 开 头 和 结尾 的 成 员 ， 都 属于 魔法 属性 /方法 。 例 如 ，_file “就 


是 获取 对 象 源码 文件 路 径 的 魔法 属性 。 下 面 是 _file_、_name 、 module “魔法 属性 的 
使 用 演示 ， 这 里 假设 代码 保存 在 名 为 test.py 的 文件 中 。 


和 一 - coding: utf-8 -=— 

import os 

class Foo (object) : 
pass 


print _file 
print os. file 


print _name 
print Foo. module__ 


该 文件 直接 运行 时 的 结果 如 下 。 


test,.py 
C:\Python27\1ib\os.pyc 
__main 

main_ 
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# 当前 文件 的 路 径 
# 指定 对 象 所 在 文件 的 路 径 


# 当前 模块 的 名 称 
# 指定 对 象 所 在 模块 的 名 称 


该 文件 被 外 部 文件 引用 时 的 运行 结果 如 下 。 


test ,py 
C:\Python27\lib\os.pyc 
test 

test 


可 以 看 到 不 同 的 使 用 环境 ， 打 印 出 来 的 结果 是 不 一 样 的 ， 这 就 是 魔法 属性 的 神奇 之 处 。 


所 以 经 常会 看 到 这 样 的 代码 : 


if _name =='_ main_': 
...do something... 


这 句 判断 只 有 在 直接 运行 文件 时 才 成 立 ， 而 如 果 是 通过 其 他 模块 引入 的 方式 ， 则 不 会 成 
立 。 通 过 这 个 特性 ， 可 以 把 某 些 只 希望 在 直接 运行 文件 时 才 执行 的 代码 放 到 这 里 ， 例 如 ， 调 


试 代码 。 


最 后 来 介绍 下 inspect 库 ， 它 是 Python 提供 的 一 个 内 省 工具 库 。 上 面 介绍 的 魔法 属性 的 
功能 ， 通 过 inspect 模块 都 可 以 实现 。 因 为 inspect 就 是 对 这 些 魔法 属性 /方法 操作 的 一 个 封 


装 集 。 下 面 是 inspect 的 使 用 样 例 。 


a 二 SOMdngs BE- == 
import inspect 
import os 


class Foo (object) : 
name = "macy'" 


def say_name (self): 


Print "my name is %s' 


$$ Foo .name 
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print inspect.getfile (os) 
print inspect.getabsfile (os) 
print inspect.getmodule (Foo) 


Print inspect.isclass (Foo) 
print inspect.ismethod (Foo.say_name) 
print inspect.isfunction(Foo.say name) 


这 段 代码 的 执行 结果 如 下 。 


C:\Python27\lib\os.pyc 
c:\python27\lib\os.py 

<module ' main ' from 'test.py'> 
True 

True 

False 


除 此 之 外 ，inspect 库 还 有 其 他 好 用 的 内 省 方法 。 感 兴趣 的 读者 可 以 通过 dir 函数 来 查看 
它 所 有 的 内 省 方法 ， 配 合 help 函数 的 使 用 就 可 以 知道 如 何 使 用 了 。 


提示 “Python 的 内 省 功能 十 分 强大 ， 这 里 仅仅 是 一 个 简单 的 演示 。 对 Python 内 省 功能 
的 熟悉 ， 还 需要 通过 不 断 使 用 和 实践 来 锻炼 。 


2.9 并 发 任务 


Python 中 执行 并 发 任务 有 三 种 方式 : 多 进程 、 多 线程 和 协 程 。 这 三 种 方式 各 有 特点 ， 各 
自 有 不 同 的 使 用 场景 。 执 行 并 发 任务 的 目的 是 为 了 提高 程序 运行 的 效率 ,但 是 如 果 使 用 不 当 
则 可 能 适得其反 。 本 节 介 绍 并 发 任务 在 Python 中 的 应 用 。 


2.9.1 多 进程 


多 进程 是 很 常见 的 并 发 任务 执行 方式 ， 也 是 最 早 支持 并 发 任务 的 方式 。 多 进程 的 优点 是 
子 进程 之 间 数 据 独 立 ， 安 全 性 较 好 ; 缺点 则 是 系统 资源 的 占用 较 大 ， 进 程 间 切换 的 开销 也 比 
较 大 。 

Python 中 实现 多 进程 的 有 os.fork 方法 、multiprocess 库 。 其 中 ，os.fork 只 有 Linux 环境 
才 有 ， multiprocess 则 是 跨 平台 的 。 

os.fork 方法 用 于 程序 自身 的 复制 ， 当 这 个 方法 被 执行 之 后 ， 程 序 就 生出 一 个 完全 一 样 的 
分 支 ， 并 且 从 此 两 个 分 支 独立 运行 。 下 面 是 os.fork 方法 的 使 用 样 例 。 
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#0—- coding: utf-8 -=— 
import os 


pid = os.fork() 
if pid == 0 : 

print 'child process ($s) and my parent is %s.' $% (os.getpid()，os.getppid()) 
SISe 3 

Print 'parent process (%s) and my child is (%s).' % (0os.getpid(), pidqd) 


print 'well be run twice!’' 


上 面 的 程序 执行 后 ， 子 进程 会 打印 第 1、3 条 语句 ， 主 进程 会 打印 第 2、3 条 语句 。 也 就 
是 说 ，fork 之 后 ， 两 份 代码 会 各 自从 fork 之 后 的 代码 开始 执行 ;而 可 以 通过 fork 返回 的 pid 
来 判断 当前 进程 属于 子 进 程 或 父 进程 。 

虽然 os.fork 是 基本 的 多 进程 实现 方式 ， 但 是 在 使 用 和 理解 上 对 于 多 数 新 手 来 说 还 不 是 
很 方便 。multiprocess 库 则 是 一 个 专门 的 多 进程 库 ， 可 以 很 方便 地 创建 子 进程 并 指定 执行 
任务 。 

使 用 multiprocess 实现 多 进程 有 两 种 方式 : 第 一 种 是 实例 multiprocess.Process 类 ， 并 传 
和 人 相应 的 执行 对 象 ; 第 二 种 是 继承 multiprocess.Process 类 ， 并 复写 其 run 方法 来 处 理 业 务 。 
第 一 种 方式 的 具体 实现 见 如 下 代码 。 

# -- coding: utf-8 -- 


import os 
from multiprocessing import Process 


def run (name) : # 子 进 程 要 执行 的 对 象 
print 'child id: %s, with %s' % (os.getpid()，name) 


if _name ==' main_': 

print 'parent id: %s' % os.getpid() 

P = Process(target=run, args=('test',)) 
p.start () 


上 面 代码 的 执行 结果 如 下 。 


parent id: 7428 
child id: 4860, with test 


这 里 直接 实例 了 Process 类 ， 并 传人 要 处 理 的 函数 及 对 应 的 函数 参数 ， 然 后 通过 调用 
start 方法 来 启动 子 进程 。 第 二 种 的 实现 代码 如 下 。 


ooding: utf- = 
import os 
from multiprocessing import Process 


class SubProcess (Process) : 
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def _init__ (self, name): 
Super (SubProcess, self). init _() 
self.name = name 


def runl(self): 

print 'child id: %s, with %s' % (0os.getpid(), self.name) 
if _ name_=='_ main 7: 

print 'parent id: %s' % os.getpid() 
p = SubProcess('test') 

p.start() 


上 述 代码 的 执行 结果 如 下 。 


parent id: 6740 
child id: 7860, with test 


可 以 看 到 执行 的 效果 是 一 样 的 ， 但 这 次 具体 的 处 理 函 数 被 封装 到 了 自 定义 的 类 中 。 这 种 


方式 的 好 处 是 可 以 对 子 进程 类 进行 更 多 的 扩展 ， 例 如 ， 提 供 一 些 对 外 的 接口 方法 。 


另外 ， 如 果 需 要 同时 启动 多 个 子 进程 处 理 一 批 任务 ， 那 么 就 可 以 使 用 进程 池 来 批量 创建 


子 进程 。 具 体 代码 如 下 。 


天 = Bog WEB = = 

import os 

import time 

import random 

from multiprocessing import Pool 


def run (name): 
print 'Child id: %s, with %s' % (os.getpid(), name) 
time.sleep (random.random()) 


LE DN et MA 
print 'Parent id: %s.' ss os.getpid() 
p = Pool() # 创建 进程 池 
for i in range(5) : 
p.apply_async (run, args=(i,)) # 并 发 处 理 目标 函数 
p.close() 
p.join() 
print 'All Done'" 
该 代码 的 执行 结果 如 下 。 


Parent id: 4908. 
Child id: 1472, with 
Child id: 5752, with 
Child id: 5752, with 
Child id: 1472, with 
Child id: 5752, with 
All Done 


nw PO 
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可 以 看 到 这 里 并 没有 启动 5 个 子 进程 ， 而 是 只 启动 了 两 个 子 进程 。 因 为 这 个 进程 池 中 的 
进程 数量 默认 等 于 CPU 的 数量 。 而 如 果 和 希望 启动 指定 数量 的 子 进程 ， 则 可 以 在 创建 进程 池 
的 时 候 指 定 即 可 。 具 体 实现 如 下 。 

P = Pool(5) # 启动 5 个 子 进程 

再 次 执行 代码 后 结果 如 下 。 

Parent id: 7372 . 

Child id: 7020，with 

Child id: 6248, with 

Child id: 6540, with 

Child id: 4592, with 


Child id: 6056, with 
All Done 


到 目前 为 止 , 我 们 已 经 可 以 通过 多 种 方式 实现 多 进程 。 但 这 只 是 开始 ， 有 了 多 进程 之 后 
还 要 解决 子 进程 之 间 的 通信 、 资 源 竞争 等 问题 。 下 面 将 分 别 进行 介绍 。 

进程 间 的 通信 方式 有 : 共享 内 存 、 管 道 、 信 号 、Socket、 外 部 存储 等 。 而 在 多 个 子 进程 
之 间 通 信 ， 最 常用 的 就 是 共享 队列 。 具 体 代码 如 下 。 


wD Po 


# -- coding: utf-8 -- 

import time 

import random 

from multiprocessing import Process, Queue 


def producer (gq, name): 
count = 1 
while True: 
q.put (u" 矿泉 水 sd" % count) 
Print(u"[%s] 生产 了 矿泉 水 $d" %$ (name, count)) 
count += 1 
time.sleep (random.random() ) 


def consumer (G，name) : 
while True: 
print (u"[%s] 取 到 [ss] 并 喝 了 它 ..." $ (name, q.get())) 
time.sleep (1) 
if _ name =='_ main ": 
q = Queue() 
P_producer = Process (target=producer, args=(q, 'kim')) 
P_consumer = Process (target=consumer, args=(q, 'lily')) 


Pp_producer.start () 
Pp_consumer.start () 


time.sleep (10) 
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P_producer.terminate () # 终止 子 进程 
P_consumer .terminate () 


上 面 是 一 个 典型 的 生产 者 与 消费 者 的 场景 。 首 先 在 主 进程 中 实例 一 个 进程 队列 对 象 ， 之 
后 启动 子 进程 时 把 队列 对 象 作 为 初始 化 参数 传递 过 去 ， 这 样 两 个 子 进程 中 都 可 以 访问 和 操作 
同一 个 队列 对 象 。 上 述 代码 执行 效果 如 下 。 


[kim] 生产 了 矿泉 水 1 
[1i1ly] 取 到 [ 矿泉 水 1] 并 喝 了 它 ... 
[kim] 生产 了 矿泉 水 2 


[lily] 取 到 [ 矿泉 水 5] 并 喝 了 它 ,. . 
[kim] 生产 了 矿泉 水 9 
[1ily] 取 到 [ 矿泉 水 6] 并 喝 了 它 ... 


关于 多 进程 之 间 的 资源 竞争 问题 ， 则 需要 通过 锁 机 制 来 解决 。 具 体 而 言 就 是 通过 锁 的 方 
式 来 控制 同一 个 时 间 内 只 有 一 个 进程 在 操作 临界 资源 。 有 了 锁 之 后 ， 只 有 拿 到 锁 的 进程 才能 
对 临界 资源 进行 操作 ， 而 其 他 进程 则 只 能 等 待 。 锁 的 使 用 代码 如 下 。 


= oo0UIng: Wt-6: = 一 


from multiprocessing import Process, Lock 


def writel(f, lock): 

lock.acquire() 

try: 
fs = openl(f,"a+") 
fs.write('write something\n') 
fs.close() 

finally: 
lock.release () 


有 
£f = "test.txt" 
lock = Lock() 


for i in range(3) : 
p = Process(target=write, args=(f, lock)).start() 


上 面 是 一 个 多 进程 并 发 写 文件 的 场景 。 如 果 不 使 用 锁 机 制 ， 则 最 后 写 和 人 文件 的 内 容 很 可 
能 是 乱 序 的 。 而 在 使 用 了 锁 之 后 ， 则 可 以 保证 多 个 进程 在 写 文件 时 是 同步 的 。 上 述 代 码 写 入 
文件 的 结果 如 下 。 


write something 
write something 
write something 
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提示 “如 果 使 用 Pool 进程 池 来 执行 任务 ， 那 么 也 需要 自己 处 理 好 各 进程 间 的 资源 竞争 
问题 。Pool 模块 只 是 帮助 启动 多 个 进程 ， 不 会 保证 并 发 的 进程 安全 。 


2.9.2 多 线程 

2.9.1 节 介 绍 了 多 进程 的 使 用 方式 ， 本 节 接 着 介绍 下 多 线程 的 使 用 方式 。 多 进程 虽然 可 以 
提供 并 发 的 能 力 ， 但 是 它 对 系统 资源 的 消耗 也 非常 大 ， 每 个 进程 都 需要 申请 独立 的 运行 环境 
和 资源 ， 并 且 子 进程 之 间 的 上 下 文 切换 也 需要 额外 的 时 间 。 

由 于 这 些 原因 所 以 就 有 了 多 线程 的 概念 。 相 比 于 多 进程 ， 多 线程 则 是 多 个 线程 共享 一 个 
进程 ， 所 以 只 需 申请 一 份 系统 资源 ; 并 且 线程 间 的 上 下 文 切换 也 更 加 高 效 ; 另外， 线程 间 的 
通信 也 变 得 更 加 方便 。 

Python 中 多 线程 使 用 threading 模块 来 实现 ; 该 模块 下 Thread 类 为 线程 实例 类 ，Lock 为 
线程 锁 类 。 如 下 代码 为 多 线程 的 使 用 样 例 。 


# -- coding: utf-8 -- 
import threading 


n=0 


def inc (max) : 
global n 
for i in range (max): 
n=n+1 
Print '%s => %d' % (threading.current thread() .name, n) 


if _ name =='_ main_': 
for i in range(1) : 
threading.Thread (target=inc, args=(1000,)).start() 


上 述 代码 中 ， 在 执行 inc 方法 时 ， 并 没有 直接 执行 而 是 通过 新 启动 一 个 线程 来 执行 的 。 
多 线程 实例 方式 与 多 进程 类 似 ， 实 例 时 需要 传递 一 个 待 处 理 的 函数 ， 如 果 有 参数 则 通过 args 
来 传递 。 代 码 执行 效果 如 下 。 


Thread-1 => 1 
Thread-1 => 2 


Thread-1 => 1000 


上 述 代码 只 启动 一 个 子 线程 来 执行 inc 函数 时 ， 程 序 会 正常 执行 。 如 果 希 望 使 用 更 多 的 
线程 来 同时 执行 ine 函数 ， 则 结果 可 能 与 所 想 的 有 所 出 人 。 直 接 把 启动 线程 代码 替换 成 如 下 
代码 ， 再 次 执行 。 
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if name 一" main 7: 
for i in range(5): 着 启动 5 个 子 线程 
threading.Thread (target=inc, args=(1000,)).start() 


按照 正常 逻辑 ，1 个 线程 执行 1000 次 循环 ， 结 果 为 1000， 那 么 5 个 线程 分 别 执行 1000 
次 循环 ， 结 果 应 该 为 5000， 而 最 后 执行 的 结果 如 下 。 


Thread-1 => 1 
Thread-2 => 2 


Thread-3 => 4954 
Thread-3 => 4955 


是 的 ， 本 次 最 后 一 个 结果 是 4955， 并 非 我 们 想象 的 5000。 并 且 下 次 执行 这 个 数 可 能 又 
变 成 了 4940。 其 原因 是 多 线程 共同 操作 的 共享 变量 n， 在 这 里 属于 临界 资源 ; 多 个 线程 对 它 
的 操作 有 竞争 关系 ， 但 在 程序 里 却 没有 处 理 资源 竞争 的 问题 。 

同 多 进程 一 样 ， 处 理 竞争 问题 时 可 以 使 用 锁 机 制 。 而 多 线程 使 用 的 锁 是 线程 锁 ， 存放 在 
threading 模块 中 。 在 加 入 锁 之 后 原 代码 更 新 后 的 内 容 如 下 。 


生 = 
import threading 


lock = threading.Lock() 
n=0 


def inc (max) : 
global n 
for i in range (max) : 
lock.acquire () # 申请 锁 
try: 
n=n+1 
Print '%s => %d' % (threading.current thread() .name, n) 
finally: 
lock.release () # 释放 锁 


if _name =='_ main “": 
for i in range(5): 
threading.Thread (target=inc, args=(1000,)).start() 


这 里 每 次 在 循环 开始 时 都 会 申请 锁 ， 接 着 处 理 循环 体 中 的 内 容 ， 而 每 次 循环 结束 时 都 会 
释放 掉 锁 。 这 样 就 可 以 保证 每 次 只 有 一 个 线程 对 共享 变量 n 进行 赋值 操作 。 新 代码 执行 结果 
为 期 望 的 5000。 


注意 ”使 用 多 线程 虽然 比 多 进程 更 轻 量 级 ， 但 如 果 使 用 的 是 Cython 解释 器 ， 那 么 可 能 
需要 了 解 下 GIL (全 局 解释 器 锁 )。GIL 对 多 线程 执行 有 一 定 的 影响 ， 尤 其 是 在 多 核 CPU 上 。 
所 以 如 果 希 望 在 多 核 CPU 上 使 用 多 线程 ， 则 要 先 确保 任务 属于 IO 密集 型 的 。 
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2.9.3 协 程 


多 进程 会 消耗 系统 资源 ， 多 线程 则 有 GIL 的 限制 和 影响 ， 那么 Python 中 还 能 高 效 地 执 
行 并 发 任务 吗 ? 答案 是 能 。 

协 程 又 称 为 微 线程 ， 是 比 线程 更 轻 量 级 的 概念 。 协 程 通过 在 单个 线程 内 进行 函数 执行 切 
换 来 实现 并 发 。 也 就 是 说 ， 协 程 是 单线 程 执行 ， 并 且 在 线程 内 函数 之 间 的 执行 是 可 以 切换 的 。 

如 果 说 多 进程 、 多 线程 是 抢占 式 的 任务 处 理 方式 ， 那 么 协 程 则 是 协作 式 的 任务 处 理 方 
式 。 协 程 虽然 是 单线 程 ， 但 是 通过 协作 切换 来 充分 利用 CPU， 所 以 也 可 以 实现 高 并 发 的 场 
景 。 图 2-12 一 图 2-14 分 别 是 多 进程 、 多 线程 、 协 程 的 工作 示意 图 ， 图 2-15 则 是 多 进程 配合 
协 程 的 示意 图 。 


图 2-12 ”Python 多 进程 


多 进程 时 程序 会 启动 多 个 和 自己 一 样 的 子 进程 ， 每 个 子 进 程 有 自己 的 GIL， 所 以 多 进程 
在 多 核 CPU 上 不 会 受 GIL 的 影响 。 


2-13 ”Python 多 线程 


多 线程 时 程序 会 通过 进程 内 的 主线 程 来 启动 子 线程 。 因 为 在 同一 个 进程 内 ， 所 有 线程 都 
共用 同一 个 GIL， 所 以 多 线程 在 多 核 CPU 上 最 后 还 是 变 成 串 行 执行 。 


GIL 


图 2-14 Python 协 程 
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协 程 是 通过 分 割 主线 程 的 计算 能 力 来 实现 的 。 在 单线 程 的 情况 下 ， 协 程 始 终 都 能 获得 到 
GIL， 所 以 不 会 受 GIL 影响 。 如 果 希 望 通过 协 程 利用 多 核 CPU 的 计算 能 力 ， 那 么 只 能 通过 多 


进程 与 协 程 配合 的 模式 。 具 体 示 意 如 图 2-15 所 示 。 
多 进程 + 协 程 


主线 程 


GIL 


GIL 


GIL 


图 2-15 Python 多 进程 + 协 程 
理解 协 程 的 概念 之 后 ， 再 来 看 看 协 程 在 Python 中 的 实现 方式 。 还 记得 在 函数 生成 器 小 
节 中 使 用 过 的 yield 关键 字 吗 ? yield 关键 字 具 有 保持 函数 现场 的 能 力 ， 并 在 下 次 调用 时 再 恢 
复 函 数 现场 。 如 果 给 yield 添加 上 接收 信息 的 能 力 ， 那 么 它 就 可 以 实现 协 程 了 。 下 面 是 一 个 


简单 的 协 程 使 用 示例 。 


# -- coding: utf-8 -- 
def consumer () : 
is 
while True: 
n= yieldr 
if not n: 
return 
print('Consuming %s...' % n) 
r= '200 OK' 


def produce (c) : 
Cc.next() ##c.send(None) 
n=0 
while n < 3: 
n=n+1 
print('Producing %s...' % n) 
r= c.send(n) 
print('Consumer return: %s' % r) 
c.close () 


# 返回 r， 并 接受 send 发 送 的 数据 赋值 给 n 


# 协 程 切换 ， 并 发 送 处 理 数据 
#yield 返回 的 结果 
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LE name ==' main _': 
c=consumer() ## 创建 一 个 协 程 子 程序 
produce (c) 
上 面 的 代码 中 consumer 是 协 程 子 程序 ， 可 以 通过 send 方法 切换 执行 协 程 子 程序 ， 并 且 
可 以 附带 一 个 参数 过 去 。 当 协 程 子 程序 执行 结束 时 ， 会 返回 执行 结果 给 调用 函数 。 最 后 处 理 
完 所 有 任务 之 后 通过 close 方法 关闭 协 程 子 程序 。 这 段 程序 执行 的 结果 如 下 。 


Producing 1... 
Consuming 1... 
Consumer return: 200 OK 
Producing 2... 
Consuming 2... 
Consumer return: 200 OK 
Producing 3... 
Consuming 3... 
Consumer return: 200 OK 


从 上 面 的 执行 流程 可 以 理解 ， 协 程 的 执行 其 实 是 单个 线程 不 断 地 切换 执行 函数 。 与 普通 
函数 调用 不 同 的 是 ， 协 程 不 是 依次 调用 的 关系 ， 而 是 相互 切换 的 关系 。 相 当 于 函数 之 间 按 照 
规律 相互 协作 来 完成 一 个 任务 ， 故 名 协 程 。 

那么 协 程 为 什么 会 比 多 线程 模式 效率 更 高 呢 ? 前 面 已 经 提 到 过 ，Cython 解释 器 的 多 线程 
有 GIL 的 限制 ， 而 协 程 没有 。 多 线程 切换 上 下 文 需要 消耗 资源 ， 而 协 程 切换 则 不 需要 。 通 过 
与 多 进程 配合 ， 协 程 也 可 以 充分 利用 多 核 CPU。 

前 面 的 例子 只 是 为 了 说 明 协 程 的 执行 流程 ， 真 正 要 使 用 协 程 来 实现 阻塞 切换 ， 要 比 这 复 
杂 得 多 。 幸 运 的 是 ， 第 三 方 已 经 支持 协 程 模式 ， 并 且 封装 好 关于 协 程 的 一 切 处 理 。 这 里 介绍 
的 是 gevent 库 ， 它 可 以 很 方便 地 帮助 我 们 使 用 协 程 处 理 并 发 。 一 个 简单 的 例子 如 下 。 


= SOUing: tf=8 = 一 
import gevent 

from gevent import monkey 
monkey.patch_ socket () 


import sys 
from urllib2 import urlopen 


urls = [ 
'http://www.yandex.ru', 
'http://www.python.org', 
"http://www.baidu.com' 
] 


def print request (url): 
print('Starting %s' 当 url) 
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data = urlopen (url) .read() 
print('%s: %d bytes' % (ur1l，1len(data) )) 


if name == main 7 了 5 
jobs = [gevent.spawn(print request, url) for url in urls] 
gevent .wait (jobs) 


这 上段 代码 中 新 建 协 程 使 用 的 是 gevent.spawn 方法 ， 它 的 使 用 与 多 线程 很 相似 。 第 一 个 参 
数 是 要 执行 的 函数 ， 后 面 跟 的 则 是 函数 的 参数 ; 只 是 这 里 的 参数 需要 依次 传递 ， 而 并 非 像 多 
线程 地 传递 一 个 元 组 。 上 述 代码 的 执行 结果 如 下 。 


Starting http://www.yandex.ru 
Starting http://www.python.org 
Starting http://www.baidu.com 
http://www.baidu.com: 112712 bytes 
http://www.python.org: 48879 bytes 
http://www.yandex.ru: 73452 bytes 


从 执行 结果 可 以 看 到 baidu 是 最 后 请 求 的 ， 却 是 最 先 返 回 结 果 的 ， 说 明 后 台 是 异步 执行 
的 。 而 如 果 没 有 使 用 gevent， 那 么 这 三 个 URL 请 求 将 会 被 顺序 地 执行 并 返回 结果 。 


注意 在 使 用 gevent 时 ， 需 要 先 确保 执行 函数 中 的 IO 模块 是 非 堵 塞 的 ， 否 则 协 程 将 不 
能 支持 并 发 执行 。 样 例 中 的 monkey. patch_socketl 方法 就 是 用 于 动态 为 Python 的 socket 标准 
库 打 补丁 的 。 其 作用 就 是 让 原本 IO 堵塞 的 socket 模块 变 为 非 堵塞 的 形式 。 因 为 urllib2 是 基 
于 socket 模块 的 ， 所 以 这 段 代 码 的 并 发 能 力 会 生效 。 


2.10 编 解码 


在 Python 2.7 版 本 中 ， 对 于 新 手 经 常会 遇 到 的 一 个 问题 就 是 编 解码 问题 。 尤 其 是 当 我 们 
处 理 一 些 中 文字 符 内 容 的 时 候 。 本 节 介 绍 下 Python 中 如 何 避 免 和 处 理 编 解码 问题 。 

在 Python 解释 器 中 字符 串 有 两 种 类 型 str、unicode。 其 中 ，unicode 是 默认 的 类 型 ; 而 
str 则 是 unicode 之 外 的 其 他 类 型 ， 可 能 是 ascII、gbk、nutf-8 等 。unicode 类 型 只 存在 于 Python 
解释 器 中 ， 当 需要 向 外 输出 时 需要 将 unicode 类 型 转换 成 对 应 的 str 类 型 ; 而 从 外 部 读 取 数据 
时 则 需要 从 str 类 型 转 成 unicode 类 型 。 正 常 的 字符 转 码 使 用 流程 如 图 2-16 所 示 。 

如 果 按 照 这 个 流程 来 进行 字符 的 编 解码 ， 那 么 程序 就 不 会 出 现 编 解 码 问 题 。 而 之 所 以 会 
出 现 编 解 码 问 题 ， 是 因为 通常 使 用 的 流程 如 图 2-17 所 示 。 

因为 不 同 编码 之 间 是 不 兼容 的 ， 而 Python 只 会 通过 unicode 进行 转 码 ， 它 不 会 直接 帮 有 我 
们 把 gbk 转换 成 utf-8。 所 以 当 输 入 的 内 容 没 有 经 过 转 码 直接 输出 到 另 一 种 编码 的 存储 时 ， 编 
解码 问题 就 会 发 生 。 
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图 2-16 Python 编 解码 示意 
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图 2-17 Python 编 解 码 错误 流程 


yb 


为 了 避免 编 解码 问题 ， 官 方 推荐 的 做 法 是 : 对 于 所 有 输入 的 内 容 都 统一 转换 成 unicode 
类 型 。 这 样 就 保证 了 Python 解释 器 中 只 有 unicode 编码 的 字符 ， 而 程序 在 输出 时 Python 解释 


需 则 会 根据 输出 的 需要 对 unicode 内 容 进行 编码 。 


前 面 介绍 的 是 编 解码 问题 的 原因 和 避免 问题 的 规范 ， 而 具体 到 项 目 本 身 需 要 进行 配置 的 


操作 有 如 下 几 个 方面 。 
口 Python 源 代 码 文件 编码 设置 。 
口 Python 解释 器 输出 编码 设置 。 
口 外 部 文件 编码 处 理 。 
口 数 据 库 编码 处 理 。 


2.10.1 源码 文件 编码 


由 于 在 Python 源 文件 中 也 经 常会 直接 定义 和 使 用 中 文字 符 ， 所 以 Python 源 文件 也 是 字 


符 内 容 的 外 部 输入 之 一 。 
对 于 源 文件 而 言 ， 首 先 要 确保 的 是 文件 本 身 的 编码 与 文件 头 部 日 


昌明 的 编码 是 一 至 


的 。 例 


如 ， 保 存 源码 文件 时 选择 的 编码 格式 为 utf8。 那 么 在 该 源码 文件 的 头 部 则 需要 有 如 下 申明 。 


== coding: Wtf-8 = 一 
print ' 中国 ' 


其 中 ， 第 一 行 的 # 一 coding: utf-8 一 就 是 编码 申明 ， 解 释 器 会 根据 这 个 


明 来 解码 源 文 
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件 中 的 字符 输入 。 编 码 申 明 需 要 在 源码 文件 顶部 申明 ， 建 议 为 第 一 行 ; 在 Linux 环境 下 第 一 
行 需要 留 给 执行 程序 的 申明 ， 此 时 可 以 放 在 第 二 行 ， 如 下 所 示 。 
#!/usr/bin/python 


#— oding: utf-B8 一 一 
print ' 中 国 ' 


提示 在 无 编码 申明 的 情况 下 ,解释 器 会 根据 系统 的 默认 编码 来 解码 。 当 源 文件 编码 与 
默认 的 编码 一 致 时 ， 则 不 需要 使 用 头 部 编码 申明 。 但 为 了 代码 的 健壮 性 ， 通 常 都 会 显 式 地 设 
置 好 编码 申请 。 


经 过 之 前 的 设置 之 后 ， 代 码 虽 然 可 以 正常 运行 ， 但 源码 中 的 字符 在 解释 器 中 的 编码 并 不 
是 unicode 类 型 ， 而 是 源码 文件 的 类 型 。 例 如 ， 前 面 示 例 中 为 utf-8 类 型 。 如 果 希 望 源码 文件 
的 字符 在 解释 器 中 直接 为 unicode 类 型 ， 则 只 要 显 式 地 定义 字符 内 容 即 可 。 代 码 如 下 。 

== wodings Ht- == 

a=u' 中 国 ' 

print type(a) # => unicode 

通过 在 字符 串 前 面 添加 一 个 u 字 符 ， 即 可 申明 字符 串 为 unicode 类 型 。 这 样 申明 的 字符 
串 在 载 人 解释 器 时 会 被 自动 转 为 unicode 类 型 。 


2.10.2 ”解释 器 默认 编码 


前 面 介绍 过 在 Python 中 的 解释 器 环境 ， 默 认 使 用 unicode 编码 。 当 需要 把 字符 内 容 向 外 
输出 时 ， 可 以 给 解释 器 指定 一 个 编码 ， 如 gbk、utf-8 等 。 如 果 没 有 指定 则 解释 器 会 使 用 一 个 
默认 的 系统 编码 。 最 典型 的 场景 就 是 向 命令 行 输出 打印 信息 时 ， 解 释 器 选择 的 就 是 默认 输出 
编码 。 这 个 默认 编码 的 取 值 顺序 如 下 。 

(1 ) 系统 的 默认 编码 。 

(2 ) IDE 设置 的 编码 。 

(3 ) 代码 设置 的 编码 。 

优先 级 越 后 越 高 ， 即 通过 代码 指定 输出 编码 的 优先 级 最 高 ， 而 系统 默认 的 编码 则 是 根据 
操作 系统 的 语言 来 设置 的 ，Python 启动 时 会 自动 设置 。 这 个 编码 是 可 以 预先 设置 的 ， 具体 的 
设置 代码 如 下 。 


import sys 


print sys.getdefaultencoding () # 打印 系统 的 默认 编码 
reload (sys) 
sys.setdefaultencoding ("UTF-8") ## 设置 默认 编码 方式 为 utf-8 


print sys.getdefaultencoding() 
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这 段 代 码 在 Windows 系统 执行 时 ， 打 印 内 容 如 下 。 


asci # => 默认 的 系统 编码 
UTF-8 # => 设置 后 的 编码 


在 Linux 系统 执行 时 ， 第 一 行 的 编码 值 会 根据 不 同 的 系统 编码 设置 而 不 同 ， 第 二 行 则 仍 
然 为 utf8。 即 通过 这 段 代 码 可 以 把 Python 系统 中 的 输出 编码 默认 修改 为 指定 的 编码 ， 这 里 
则 修改 为 utf-8。 


2.10.3 ”外 部 文件 编码 


外 部 文件 是 指 Python 程序 需要 读 取 的 外 部 数据 文件 ， 如 txt、xml、json 等 文件 。 当 这 些 
外 部 文件 中 包含 非 英文 字符 时 ， 读 取 时 就 需要 指定 正确 的 文件 编码 。 理 想 情况 下 ， 我 们 假定 
已 知 外 部 文件 的 编码 ， 则 打开 时 指定 编码 的 方式 如 下 。 


#!/usr/bin/python 

类 一 = codings utf=8 = 一 

import codecs 

f = codecs.open('test.txt', 'rw', 'utf8') 


这 里 使 用 了 codecs 模块 ， 是 专门 用 于 解决 文件 编码 问题 的 库 。 它 可 以 很 好 地 解决 文件 读 
写 的 编 解 码 问题 。 另 外 一 些 时 候 ， 并 不 总 是 能 知道 需要 读 取 文件 的 编码 ， 这 时 就 需要 提前 判 
断 文件 的 编码 类 型 。 具 体 的 方式 如 下 。 


#!/usr/bin/python 
# -- coding: utf-8 -- 


str = ' 中 国 
# 第 一 种 方式 
for code in ['utf-8'，'gbk']: 
if str.decode (code，'ignore')==str.decode (code， 'replace'): 
Print code 
break 
# 第 二 种 方式 
for code in [vtf=-8'; "gbk’]: 
try: 


str.decode (code) 
Print code 
break 

except (e) : 
pass 


# 第 三 种 方式 
import chardet 
print chardet.detect (str) 


这 段 代码 一 共 给 出 了 三 种 判断 字符 编码 的 方式 。 前 两 种 为 hack 的 方式 判断 字符 编码 。 
对 于 非 英 文字 符 的 判断 通常 能 正确 工作 ， 而 对 于 只 含有 英文 字符 的 判断 则 可 能 会 不 准确 。 第 
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三 方式 判断 字符 的 编码 会 更 加 准确 ,但 是 需要 额外 安装 第 三 方 库 。 


2.10.4 ”数据库 编码 


数据 库 作为 最 常用 的 外 部 数据 源 ， 其 读 取 和 写 和 人 都 需要 预先 设置 好 编码 方式 。 例 如 ， 数 
据 库 的 编码 为 gbk， 那 么 在 连接 数据 库 时 就 需要 指定 编码 为 gbk。 以 MySQLdb 库 为 例 设置 编 
码 方式 如 下 。 


conn=MySQLdb.Connect (host="localhost",user="root",passwd="root",db="test",chars 
et="gbk") 


这 里 建立 了 一 个 数据 库 连 接 ，IP 为 本 机 地 址 ， 用 户 名 为 root， 密 码 为 root， 数 据 库 名 为 
test， 编 码 为 gbk。 通 过 该 连接 读 取 数据 时 ， 返 回 的 数据 编码 直接 为 unicode 类 型 。 而 当 我 们 
需要 写 人 数据 到 数据 库 时 ， 记 得 要 提前 把 数据 都 转换 为 unicode 或 gbk 类 型 。 


2.10.5 _ 编 解码 函数 

尽管 强调 要 尽 可 能 保持 Python 解释 器 中 只 有 unicode 编码 ， 但 在 实际 的 编码 过 程 中 很 难 
避免 出 现 不 同 编码 的 字符 。 这 时 就 需要 使 用 编 解码 函数 来 解决 编码 不 一 致 的 问题 。 在 Python 
中 可 以 进行 编 解 码 的 函数 有 str.decode、str.encode、unicode、str。 

1. 解码 

当 获 取 到 的 字符 类 型 为 str 时 ， 则 它 有 可 能 是 ASCIT、gbk、utf-8 等 编码 中 的 一 种 。 此 
时 的 字符 为 已 编码 形式 ， 将 str 转换 为 unicode 类 型 即 为 解码 。 可 以 使 用 str 对 象 的 decode 方 
法 ， 具 体 使 用 方式 如 下 。 


# = 一 CONG VtE-B =— 


a=' 中 国 ' 

print type(a) # => str 

b = a.decode ('utf-8') # 使 用 utf-8 进行 解码 
print type (b) # => unicode 


此 外 ， 解 码 还 可 以 使 用 unicode 内 建 函数 ， 与 decode 不 一 样 的 是 ，unicode 使 用 Python 
系统 默认 的 编码 来 解码 。 具 体 使 用 方式 如 下 。 
=- eodings utf=B 一 = 


import sys 
reload (sys) 


sys.setdefaultencoding ("UTF-8") ## 设置 系统 默认 编码 
a=' 中 国 ' 

print type(a) # => str 

b = unicode (a) # 使 用 系统 默认 编码 解码 


Print type (b) # => unicode 
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2. 编码 
编码 的 过 程 与 解码 刚好 相反 ， 即 从 unicode 转换 为 str 类 型 。 可 以 使 用 str 对 象 的 encode 
方法 ， 具 体 使 用 方式 如 下 。 


# -- coding: utf-8 -- 


a=u"' 中 国 ' 

print type(a) # => unicode 

b = a.encode('UTF-8') # 以 utf-8 进行 编码 
print type (b) # => str 


同样 地 使 用 str 内 建 函 数 也 可 以 将 unicode 类 型 转换 为 str 类 型 ， 并 且 使 用 的 也 是 系统 默 
认 的 编码 。 具 体 使 用 方式 如 下 。 
wodings: utf=6 = 


import sys 
reloadl(sys) 


sys.setdefaultencoding ('UTF-8') ## 设置 默认 编码 

a = u' 中 国 ' 

print type(a) # => unicode 

b = str(a) # 使 用 默认 编码 进行 编码 
print type(b) # => str 


提示 str 内 置 函数 除了 可 以 把 unicode 类 型 转换 成 str 类 型 ， 还 可 以 把 其 他 类 型 转换 成 
str 类 型 。 例 如 , int、float、 tuple、 list 等 。 而 对 于 一 个 自 定 义 对 象 ， 如 果 希 望 能 被 str 函数 转换 ， 
则 需要 自己 实现 _str 方法， 并 在 该 方法 内 返回 转换 后 的 字符 串 内 容 。 


CHAPTER 
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在 正式 介绍 Web UI 自动 化 测试 相关 章节 之 前 ， 针 对 一 些 初学 者 而 言 还 需要 额外 补充 下 
相关 基础 知识 。 这 些 基础 知识 不 仅 是 Web UI 自动 化 的 知识 ， 同 时 也 是 Web 开发 的 基础 知识 。 
掌握 了 这 些 基 础 知识 之 后 ， 在 后 续 的 自动 化 脚本 开发 时 才能 更 好 地 发 现 问题 和 解决 问题 。 

本 章 主 要 介绍 的 内 容 包括 HTML、DOM、CSS 等 Web 相关 技术 。 


3.1 HTML 与 DOM 简介 


HTML 全 称 为 超 文 本 标记 语言 ， 是 网 页 制作 与 Web 开发 所 使 用 的 语言 。 其 特点 是 简单 
易学 、 平 台 无 关 且 通 用 性 较 好 。HTML 的 标准 是 由 W3C 组 织 提出 的 ， 目 前 最 新 的 规范 是 
HTML5。 

HTML 不 是 编程 语言 ， 而 是 一 个 标记 语言 ， 它 有 自己 的 一 套 标记 标签 ， 并 且 使 用 这 些 标 
记 标 签 来 描述 网 页 的 内 容 。 浏 览 器 接收 到 这 些 标记 文本 后 ， 按 照 预定 的 行为 来 解析 并 展示 到 
页 面 上 。HTML 标签 的 规则 如 下 。 

口 由 尖 括 号 包围 关键 字 组 成 ， 例 如 <html>。 

口 通常 都 是 成 对 出 现 ， 例 如 <div> 和 </div>。 

口 成 对 出 现时 第 一 个 为 开始 标签 ， 第 二 个 为 结束 标签 。 

口 有 时 会 是 单 标签 ， 例 如 <input name="kw"/>。 

口 标签 可 以 拒 套 但 不 能 交叉 内 套 。 
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口 不 同 的 标签 有 它 自己 的 功能 和 定义 ， 例 如 ，<b> 标签 可 以 使 文本 加 粗 。 
HTML 页 面 就 是 由 这 些 特 定 含义 的 标签 对 与 文本 内 容 所 组 成 的 ， 开 发 人 员 会 根据 不 同 的 
需求 选用 对 应 的 标签 来 开发 网 页 。 下 面 就 是 一 个 最 简单 的 HTML 页 面 源码 。 


<html> # 网 页 根 标签 
<head> 
<title> 测试 页 面 </title> 
<meta charset="utf-8"> 
</head> 


<body> # 网 页 主体 标签 
<h1> 我 是 一 级 标题 </h1> # 标题 标签 
<p> 我 是 一 个 段落 。</p> # 段落 标签 
</body> 


</html> 


上 述 的 HTML 源码 在 浏览 器 中 被 加 载 之 后 的 效果 如 图 3-1 机 ee 
所 示 。 二 四 我 是 一 级 标题 

从 上 述 代码 中 可 以 看 出 ，HTML 的 基本 结构 是 <html> 与 我 是 一 个 段落 
</html> 作为 最 外 层 标 签 ， 其 下 有 <head><body> 标签 。<head> 
标签 下 可 以 包含 <title><meta> 等 标签 。<body> 标签 下 则 可 以 包 图 34 本 DT 和 下 
含 更 多 的 HTML 标签 ,例如 div、p、table、input 等 。 

其 中 ，<html><head><body> 这 三 者 的 结构 是 固定 的 ， 并 且 <head> 标签 下 的 内 容 也 基本 
为 固定 形式 。 只 有 <body> 标签 下 的 内 容 与 形式 不 是 固定 的 ， 因 为 <body> 中 的 内 容 是 需要 在 
页 面 上 显示 的 元 素 ; 而 不 同 的 页 面 显示 内 容 各 有 所 需 ， 所 以 <body> 下 的 内 容 与 形式 会 根据 
需要 定制 成 各 种 形式 。 具 体 而 言 ，<body> 下 的 标签 可 以 分 为 如 下 几 种 类 型 。 

口 格式 标签 : 用 于 规范 页 面 格式 显示 的 标签 。 例 如 ， 块 区 域 标签 div、 段 落 标 签 <p>、 

换行 标签 <br> 等 。 
口 文本 标签 : 用 于 约束 文本 内 容 显 示 的 标签 。 例 如 ，<b> 加 粗 标签 、<i> 斜体 标签 、 
<font> 字体 标签 等 。 

口 图 像 标签 : 用 于 显示 图 片 的 标签 。 主 要 为 <img> 标签 。 

口 超 链接 标签 : 用 于 连接 和 跳 转 页 面 的 标签 。 通 常 为 <a> 标签 。 

口 表格 标签 : 用 于 回 显 表格 内 容 的 标签 。 通 常 为 <table> 标签 。 

除了 上 述 举例 的 这 些 标签 之 外 ，HTML 还 有 很 多 同类 型 不 同 功能 的 标签 。 想 要 全 部 了 解 
的 读者 可 以 参见 HTML 规范 http:/www.w3school.com.cn/tags/html_ref byfunc.asp。 

在 正常 的 网 页 开发 过 程 中 ， 就 是 使 用 各 种 不 同 功能 的 HTML 标签 来 组 装 成 我 们 需要 的 
页 面 内 容 。 而 浏览 器 在 接收 到 HTML 内 容 后 并 不 是 直接 显示 HTML 本 身 ， 而 是 显示 了 其 对 
应 的 网 页 效果 。 这 是 因为 浏览 器 自身 拥有 解析 HTML 并 演 染 页 面 的 功能 ， 在 泻 染 页 面 的 过 程 
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中 ,浏览 器 还 会 创建 一 个 叫 作 DOM 的 对 象 。 

DOM 全 称 为 文档 对 象 模型 ， 是 W3C 组 织 推荐 的 处 理 可 扩展 语言 的 标准 编程 接口 。 它 是 
浏览 器 在 解析 HTML 页 面 的 过 程 中 生成 的 一 个 内 部 对 象 。 在 DOM 对 象 中 把 页 面 (或 文档 ) 
的 对 象 都 组 织 在 一 个 树 状 结构 中 ， 其 树 状 结构 中 的 每 一 个 对 象 都 是 与 源 HTML 中 的 节点 一 一 
对 应 的 。 例 如 ， 前 段 代 码 中 的 HTML 内 容 其 对 应 的 DOM 对 象 结构 如 下 。 


1--html 


| I=~titie 
| 1--meta 


| 
jw 
1--P 

浏览 器 最 终 在 泻 染 和 显示 网 页 内 容 的 时 候 正 是 基于 DOM 对 象 的 内 容 而 来 的 ， 并 且 
DOM 对 象 一 旦 被 修改 浏览 器 将 会 重新 泻 染 页 面 内 容 。 而 另 一 方面 DOM 本 身 就 是 一 个 可 编程 
的 接口 ， 即 我 们 可 以 通过 编程 的 方式 调用 它 。 简 而 言 之 ， 我 们 可 以 通过 编程 来 动态 改变 页 面 
显示 的 效果 。 

大 部 分 基于 Web 的 自动 化 测试 工具 都 是 通过 操作 DOM 来 控制 浏览 器 行为 的 ， 而 我 们 在 
进行 自动 化 测试 脚本 开发 的 时 候 ， 其 中 一 个 重要 的 知识 点 就 是 如 何 定位 DOM 中 的 元 素 ; 在 
定位 到 元 素 之 后 自动 化 工具 就 可 以 对 其 DOM 节点 进行 相关 操作 ， 来 实现 自动 化 测试 Web 页 
面 的 效果 。 接 下 来 将 学 习 如 何 定位 一 个 Web 元 素 。 


3.2 学习 元 素 定 位 方式 


Web 的 UI 自动 化 测试 步骤 有 元 素 定位 、 元 素 操作 、 再 次 元 素 定位 、 元 素 信息 获取 、 结 
果 检 查 等 这 几 个 步 又。 其 中 ， 元 素 定位 是 葛 定 整个 测试 过 程 的 基础 ， 如 果 找 不 到 元 素 我 们 既 
不 能 操作 页 面 ， 也 不 能 获取 页 面 信息 ， 自 然 就 无 法 进行 自动 化 测试 。 因 此 元 素 的 定位 技术 是 
我 们 学 习 Web 自动 化 测试 所 必须 掌握 的 一 项 技能 。 

所 谓 的 元 素 定 位 ， 即 根据 元 素 的 特定 属性 对 元 素 进行 定位 描述 的 一 项 技术 。 也 就 是 说 ， 
对 元 素 进行 定位 时 需要 先 了 解 元 素 具 有 哪些 属性 ， 然 后 依据 这 些 属性 就 可 以 编写 出 针对 该 元 
素 的 定位 符 。 那 么 元 素 具 体 有 哪些 属性 呢 ? 下 面 列 出 了 在 Web 自动 化 测试 过 程 中 经 常用 来 进 
行 元 素 定 位 的 常用 属性 。 

口 ID 属性 。 能 唯一 定位 一 个 元 素 的 属性 ， 优 先 选取 的 定位 属性 。 
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口 Class 属性 。 广 泛 使 用 的 定位 属性 。 

口 Name 属性 。 

口 TagName 属性 。HTML 节点 的 标签 名 ， 如 input、a 等 。 
图 3-2 中 标注 出 每 一 个 属性 在 HTML 页 面 中 的 具体 形式 。 


vespan id-"s kw wrap” class-"bg s ipt wr quickdelete wrap ipthover™> 


span class-"soutu-btn" ></span> 
ocWplete- “off 
a re araeeripeas id="quickdelete Ne 清空 ”cla ed esti 


epx; right: epx; display: none;">c/a> a 
yt TagName 必 性 Class 必 性 Name 属 性 ID 属性 


图 3-2 HTML 属性 分 析 


这 些 属 性 中 只 有 ID 属性 的 值 在 HTML 文档 中 是 唯一 的 ， 而 其 他 属性 的 值 在 HTML 文档 
中 可 能 会 出 现 一 次 以 上 。 因 此 ， 通 过 ID 属性 找到 的 元 素 都 是 非常 精准 的 ， 而 其 他 属性 定位 
元 素 时 有 可 能 会 匹配 到 多 个 目标 元 素 。 例 如 ， 某 页 面 中 class 值 为 fy 的 元 素 有 两 个 ， 这 种 情 
况 下 如 果 使 用 class=fly 的 属性 来 进行 定位 则 会 匹配 到 两 个 元 素 ， 导 致 元 素 定位 无 法 精确 匹配 
从 而 影响 后 续 测 试 工作 ， 因 为 不 能 保证 定位 到 的 那个 元 素 就 是 我 们 真正 需要 操作 的 元 素 。 


提示 虽然 只 有 ID 属性 是 唯一 的 ， 但 是 我 们 仍然 可 以 考虑 使 用 Class、Name 属性 进行 
元 素 定 位 ， 因 为 并 不 是 所 有 的 Class 和 Name 属性 都 有 多 个 值 存 在 ， 我 们 通过 在 HTML 页 面 
中 搜索 一 下 指定 的 Class 或 者 Name 属性 ， 如 果 只 搜索 到 一 个 结果 ， 那 么 该 属性 就 可 以 唯一 
定位 这 个 元 素 了 。 而 TagName 则 不 建议 单独 用 来 进行 定位 ， 因 此 TagName 在 页 面 中 只 出 现 
一 次 的 可 能 性 很 小 。 


上 面 提 到 的 是 利用 元 素 自 身 基本 属性 来 定位 ， 而 除了 这 些 基 本 属性 之 外 ， 还 可 以 通过 其 
他 技术 手段 来 进行 定位 ， 目 前 业内 普遍 使 用 的 定位 技术 为 XPath 和 CSS。 这 两 项 定位 技术 的 
特点 是 支持 的 定位 方式 更 多 元 化 ， 支 持 的 功能 更 强大 ， 几 乎 可 以 唯一 定位 任何 一 个 元 素 ， 可 
以 轻松 解决 一 些 日 常 工作 中 的 常见 问题 ， 具 体 如 下 。 

口 匹配 多 个 元 素 时 可 以 通过 Index 获取 指定 元 素 。 

口 可 以 使 用 更 多 的 元 素 属 性 ， 例 如 ，value、type 等 。 

口 可 以 综合 使 用 多 个 元 素 属性 ， 例 如， 同时 使 用 Class、Name 和 TagName 属性 来 定位 。 

口 可 以 分 层 进行 定位 ， 例 如 ， 先 定位 到 一 个 确定 的 父 节点 元 素 ， 再 定位 可 以 唯一 确定 的 

子 元 素 。 


提示 本 书 推荐 使 用 CSS 的 定位 技术 来 进行 元 素 定位 学 习 ， 关 于 XPath 的 定位 技术 感 兴 
趣 的 读者 可 以 通过 在 线 教程 进行 学 习 。 
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3.3 CSS 定位 技术 


其 实 CSS 定位 元 素 的 基础 依然 是 HTML 文档 中 元 素 的 属性 ， 只 是 通过 CSS 语法 我 们 可 
以 组 合成 条 件 和 层次 都 更 加 丰富 的 定位 语句 。 在 具体 学 习 复 杂 的 定位 之 前 我 们 先 来 学 习 一 下 
CSS 的 基本 定位 语法 ， 如 表 3-1 所 示 。 


表 3-1 CSS 定位 语法 


定位 资源 说 明 
ID 匹配 id=kw 的 元 素 
Class 匹配 所 有 class=fly 的 元 素 


Te 7 | ap | wp 元 
Attribute 匹配 所 有 具有 name 属性 的 元 素 
IE 


上 面 是 CSS 常用 的 基本 语法 ， 通 过 这 些 基 础 语法 就 可 以 组 合 出 更 多 的 定位 语句 。 关 于 
Selenium 支持 的 CSS 更 多 的 定位 语法 可 以 访问 http://www.testdoc.org 进行 学 习 。 接 下 来 针对 
前 面 所 列 出 的 几 种 复杂 情况 进行 CSS 定位 。 

口 获取 匹配 多 个 元 素 中 的 指定 一 个 。 


table>tr:nth-child (1) ## 定位 table 元 素 下 的 第 1 个 tr 元 素 

口 使 用 更 多 的 元 素 属性 。 

input [type=text] [value=1] ## 定位 type 为 text，value 为 1 的 input 元 素 

口 综合 使 用 不 同 的 属性 。 

input .fly [name=wd] ## 定位 class 为 fly，name 为 wd 的 input 元 素 

口 分 层 定位 元 素 。 

form>table>a[class=dot] ## 定位 form 下 的 table 下 的 class 为 dot 的 a 元 素 
口 定位 特定 文本 内 容 的 元 素 。 

label:contains ('userName') ## 定位 包含 userName 文字 的 label 元 素 


通过 上 面 的 CSS 定位 示例 语句 ， 可 以 大 体 先 了 解 下 针对 不 同 定位 场景 ， 如 何 利 用 CSS 
定位 技术 去 解决 。 在 后 面 会 进一步 通过 代码 进行 练习 和 掌握 。 


3.4 使 用 工具 帮助 定位 


通过 上 面 的 介绍 掌握 了 如 何在 HTML 页 面 中 进行 元 素 定位 ， 方 法 虽然 可 行 ， 但 是 每 次 
都 是 手动 地 在 HTML 页 面 的 源码 里 寻找 ， 效 率 自然 就 会 非常 低 ， 所 以 本 节 中 介绍 如 何 快 速 高 
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效 地 对 目标 元 素 进行 定位 ， 即 使 用 定位 工具 来 进行 元 素 定位 。 


3.4.1 IE 的 Developer Tool 


IE 的 开发 者 工具 可 以 通过 单 击 元 素 的 方式 来 定位 页 面 上 元 素 所 对 应 的 HTML 节点 , 具 
体 的 步骤 如 下 。 


(1) 打开 下 浏览 器 。 


(2 ) 打开 一 个 页 面 ， 如 http://www.baidu.com。 


(3 ) 右 击 页 面 选择 “检查 元 素 ” 或 者 按 F12 键 打开 开发 者 工具 ， 如 图 3-3 所 示 。 


="bg 5_ipt_wr quickdelete-wrap">-</5pan> 
4 kspan class="bg s_btn_wrry 


《input classe"bg 5_btn” ide"su”typen"submit”values" 百 度 一 下 "></input> 

</span> 

b <span class="tools"y-</span> 

cinnut_names"rn® tynes"hidden”" yalues"">¢/innut> 

html body divawrapper divehead divhead.wrapper divsform divsform_wrap.. | form#form spanbg 是 


图 3-3 IE 开 发 者 工具 
(4) 单 击 “ 选 择 元 素 ” 图 标 中 或 者 按 Ctrl+B 快捷 键 。 
(5 ) 将 光标 移动 到 页 面 上 的 目标 元 素 上 并 单 击 。 


(6 ) 查看 开发 者 工具 中 有 背景 色 的 元 素 节点 ， 即 被 单 击 元 素 的 对 应 节点 。 
通过 上 面 的 步骤 ， 可 以 轻松 定位 某 个 页 面 元 素 的 对 应 HTML 节点 内 容 ， 而 无 须 手动 查 
看 源码 和 查找 关键 字 ， 既 准确 又 快速 。 


3.4.2 Firefox 的 Web 开发 者 工具 


同样 地 ，Firefox 浏览 器 也 提供 了 相似 的 工具 ， 快 捷 键 F12 或 者 右 击 选择 “查看 元 素 ” 即 
可 打开 该 工具 ， 打 开 后 的 界面 如 图 3-4 所 示 。 


| | ss 回 控制 台 ” 口 调试 器 {) 样式 编 可 器。 G@ 性 能 四 内 存 三 网络 目 存 储 


搜索 HTML 


，spanbgs_ btn_wr ，input#subgs btn > 


图 3-4 FireFox 开发 者 工 
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查看 元 素 的 方式 与 IE 基本 一 致 ， 首 先 单 击 “ 用 鼠标 选择 元 素 ”按钮 口 ， 然 后 使 用 鼠标 
单 击 目 标 元 素 ， 工具 中 有 背景 色 的 节点 即 为 被 单 击 元 素 对 应 的 HTML 节点 。 


3.4.3 ”Chrome 的 开发 者 工具 


Chrome 浏览 器 中 也 提供 了 相应 的 工具 ， 按 F12 快捷 键 或 者 右 击 选择 “检查 ”命令 即 可 
打开 该 工具 ， 使 用 方法 同 IE 和 Firefox， 具 体 界面 如 图 3-5 所 示 。 


民生 | te cole ication Secuiy Audi Ora2 1 X 


图 3-5 ”Chrome 开发 者 工具 


3.4.4 ”Firefox 的 XPath Checker 插件 


除了 使 用 开发 者 工具 来 查看 元 素 节点 的 属性 ， 还 可 以 通过 XPath 工具 来 查看 元 素 的 
XPath 路 径 ， 该 工具 可 以 自动 生成 被 单 击 元 素 的 XPath 路 径 ， 为 我 们 的 元 素 定位 提供 了 另 一 
种 方便 。 具 体 的 安装 和 使 用 步骤 如 下 。 

(1 ) 安装 Firefox 的 XPath Checker 插件 。 

(2 ) 打开 一 个 页 面 ， 如 http://www.baidu.com。 

(3 ) 右 击 目标 元 素 后 选择 View XPath 子 项 。 

(4 ) 查看 XPath Checker 界面 中 的 XPath 路 径 ， 如 图 3-6 所 示 为 百度 首页 搜索 框 的 XPath 
定位 路 径 。 


hapyhwwwwaorg/19ea1daml 


eat from hhpsyfowbaidhucomyindesphpm=monire .dg 
One mateh found 


+ 


图 3-6 Firefox 下 生成 XPath 
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3.4.5 ” Chrome 的 XPath 工具 


Chrome 中 也 提供 了 XPath 的 定位 工具 ， 而 且 已 经 直接 集成 在 它 的 开发 者 工具 中 了 ， 获 
取 元 素 XPath 路 径 的 具体 操作 步骤 如 下 。 

(1) 打开 开发 者 工具 。 

(2 ) 定位 到 具体 的 元 素 节点 。 

(3 ) 在 开发 者 工具 中 右 击 该 HTML 节点 。 

(4 ) 选择 Copy 一 Copy XPath， 如 图 3-7 所 示 。 


€ 了 | 8 htpsy/wwwbaiducom 


7| 二 


图 3-7 Chrome 下 生成 XPath 


通过 上 面 的 步 又 之 后 ， 元 素 节 点 对 应 的 XPath 路 径 就 被 复制 到 系统 的 粘贴 板 中 了 ， 可 以 
通过 粘贴 的 方式 把 XPath 路 径直 接 复制 出 来 ， 同 样 对 于 百度 首页 的 输入 框 我 们 得 到 的 XPath 


路 径 为 : //*[@id="kw"]。 


3.4.6 ”Firefox 的 CSS 插件 


同样 ， 对 于 元 素 的 CSS 路 径 Firefox 也 有 相应 的 工具 可 以 帮助 我 们 生成 。 在 火狐 中 想 要 
使 用 该 功能 ， 需 要 同时 安装 Firebug 和 FirePath 两 个 插件 ， 具 体 步骤 如 下 。 

(1) 安装 好 Firebug 和 FirePath 插件 。 

(2 ) 打开 一 个 网 页 ， 如 http://www.baidu.com。 

(3 ) 右 击 搜索 框 并 单 击 Inspect in FirePath。 

(4) 在 打开 的 FirePath 工具 中 选择 CSS， 如 图 3-8 所 示 。 


(5 ) 单 击 国 按钮 后 


日 鼠 标 单 击 目标 元 素 。 
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ul! 
1 matching node 


图 3-8 Firefox 生成 CSS 选项 


(6) 查看 CSS 后 面 的 输入 框 内 容 即 为 所 单 击 元 素 的 CSS 定位 路 径 ， 如 图 3-9 所 示 为 百 
度 搜索 框 的 CSS 定位 路 径 。 


图 3-9 Firefox 生成 CSS 路 径 


3.4.7 Chrome 的 CSS 工具 


Chrome 作为 主流 的 浏览 器 之 一 ， 也 是 支持 CSS 定位 生成 功能 的 ， 同 样 地 也 是 集成 到 了 
它 的 开发 者 工具 中 ， 具 体 的 使 用 步 又 如 下 。 

(1) 打开 开发 者 工具 。 

(2 ) 定位 到 具体 的 元 素 节点 。 

(3 ) 在 开发 者 工具 中 右 击 该 HTML 节点 。 

(4 ) 选择 Copy 一 Copy Selector 即 可 复制 该 节点 的 CSS 路 径 。 


3.4.8 Firefox 的 WebDriver Element Locator 插件 


Firefox 的 插件 库 是 相当 丰富 的 ， 对 于 定位 它 还 有 一 个 WebDriver 友 好 的 插件 叫 作 
WebDriver Element Locator。 它 不 仅 提供 了 定位 的 路 径 ， 还 提供 了 生成 WebDriver 的 代码 ， 而 
且 还 支持 WebDriver 的 多 种 语言 。 具 体 的 操作 步 又 如 下 。 
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(1) 打开 Firefox 浏览 器 ， 进 入 https://addons.mozilla.org/en-US/firefox/。 
(2 ) 在 搜索 框 里 输入 “WebDriver Element Locator ”。 
(3 ) 找到 插件 并 单 击 Download Now 按钮 ， 如 图 3-10 所 示 。 


WebDriver Element Locator 


This addon is designed to support and speed up the creation of WebDriver scripts 
by easing the location of web elements. 


图 3-10 ”WebDriver 插件 下 载 


(4) 会 有 一 个 弹出 框 ， 单 击 Install Now。 
(5 ) 在 Firefox 里 打开 http://www.baidu.com。 
(6) 右 击 百度 搜索 框 后 查看 菜单 内 容 ， 如 图 3-11 所 示 。 
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drivertind. alement by xpathCJfinputt@autocomplete='cf1 
driveriind element by xpathC //inputl@dass='sjiptT) 
driverfind. element.by.xpathC//inputl@id= 
drivertind. olemanrt. by xpath(//inputl@madength="2557") 

diiverfind element by xpathC /inputl@name="nd") 

driverind. element by ypathCJ1inpuaicontainclglautocomplete cf))) 
drverfind element by xpathCJfinputlcortainel@cassYpt 

diverfind element by xpathCJfinputicontainstedasssjipm) 

driverfind. element_by.xpathC J//inputleontainc (Ed)) 


图 3-11 WebDriver 插件 演示 
(7) 选择 对 应 的 生成 代码 子 项 即 可 生成 该 语言 的 WebDriver 脚本 。 
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该 工具 支持 生成 脚本 的 语言 有 C#、Java、Python 和 Ruby， 根 据 所 用 的 语言 不 同 可 以 选 


择 对 应 的 子 项 ， 在 这 里 可 以 直接 选择 Python Locators 子 项 。 


注意 可 以 看 到 WebDriver Element Locator 目前 仅 支持 生成 XPath 路 径 的 Selenium 定位 


脚本 ,不 支持 CSS 路 径 的 Selenium 定位 脚本 生成 。 
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3.5 ”Selenium 中 进行 元 素 定 位 


前 面 学 习 了 HTML 中 元 素 定位 的 方法 和 工具 ， 本 节 学 习 如 何在 Selenium 中 进行 元 素 的 
定位 。 


3.5.1 获取 一 个 定位 元 素 
在 Selenium 中 的 元 素 定位 是 通过 几 个 定位 接口 对 开发 人 员 开 放 的 ， 主 要 的 几 个 定位 方法 
的 名 称 如 下 。 


口 fnd_element by _class name。 


口 fnd_element by_css_selector。 

口 find_element by_ id。 

口 fnd_element_ by_link text。 

口 fnd_element by_name。 

口 fnd_element by partial link text。 

口 fnd_element by _tag_name。 

口 fnd_element by_xpath。 

上 述 定 位 元 素 的 接口 分 别 是 通过 元 素 的 ClassName、CSS 路 径 、ID、 链 接 文字 、Name、 
部 分 链接 文字 、 标 签名 以 及 XPath 路 径 来 进行 定位 的 。 我 们 要 做 的 是 在 调用 具体 方法 的 时 候 
传递 过 去 正确 的 参数 即 可 。 接 下 来 通过 一 个 示例 节点 来 说 明 下 如 何 使 用 每 个 定位 方法 。 具 体 
节点 代码 如 下 。 

<input type="text" class="s_ipt nobg_s_fm hover" name="wd" id="kw" > 

上 述 节 点 可 以 通过 以 下 几 个 方法 分 别 进行 定位 ， 如 下 。 

DD find element by _css_selector("#kw")。 

DO find element by _id("kw")。 

口 fnd_element by_xpath("//*[@id="kw"]")。 

口 fnd_element by_name("wd")。 


口 fnd_element by tag name("input")。 

其 中 ， 以 id 作为 定位 参数 的 通常 都 可 以 精确 定位 到 该 元 素 ， 而 以 Name、TagName 作为 
定位 参数 的 则 可 能 定位 到 多 个 符合 条 件 的 节点 ， 而 Selenium 则 会 返回 第 一 个 匹配 到 的 节点 元 
素 。 另 外 ， 对 应 link text 之 类 的 方法 只 适用 于 a 元 素 ， 所 以 上 面 的 input 元 素 不 可 使 用 这 类 方 
法 进行 定位 ， 接 下 来 就 看 看 如 何 通过 链接 文字 来 定位 链接 ， 示 例 节 点 代码 如 下 。 


<a href="https://www.python.org" target=" blank">python 官网 </a> 
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对 于 上 面 的 元 素 节点 ， 就 可 以 使 用 link text 的 方法 进行 定位 ， 具 体 如 下 。 

口 find_element_by_link_text("python 官网 ")。 

DD find element by partial link text("python")。 

上 面 两 个 方法 都 会 匹配 到 目标 元 素 ， 第 一 个 方法 会 匹配 到 链接 文字 为 “python 官网 ”的 
第 一 个 链接 ， 第 二 个 方法 会 匹配 到 链接 文字 包含 “python” 的 第 一 个 链接 ， 所 以 如 果 上 述 代 
码 中 的 节点 在 整个 HTML 页 面 中 是 唯一 的 或 者 最 先 出 现 的 ， 那 么 将 会 被 匹配 成 功 。 


注意 ”如 上 所 述 ，find_element_ by_ XXX 方法 返回 的 永远 是 第 一 个 匹配 到 的 元 素 ， 而 实 
际 情况 下 并 非 所 有 元 素 都 有 id 属性 ， 也 并 非 所 有 想得到 的 元 素 都 是 最 先 出 现 的 ; 那么 如 何 获 
取 匹 配 节点 中 的 非 第 一 个 元 素 ? 


3.5.2 ”获取 一 组 定位 元 素 
为 了 解决 上 面 提 到 的 问题 ，Selenium 提供 了 另外 一 套 定位 方法 ， 具 体 名 称 如 下 。 


口 fnd_elements_by_class_name。 

口 fnd_elements_by_css_selector。 

口 fnd_elements_ by_ id。 

DD find elements by _ link text。 

DO find elements by_name。 

DD find elements by partial link text。 

DD find elements by_ tag name。 

OD find elements by _xpath。 

可 以 看 到 这 一 套 方 法 和 前 面 提 到 的 方法 是 相对 应 的 ， 由 原来 的 find_element_by_XXX 变 
成 find_elements_by_XXX， 即 返回 一 组 所 有 匹配 到 的 元 素 ， 这样 开发 者 就 可 以 通过 这 个 方法 
来 处 理 匹配 到 多 个 元 素 时 的 情况 。 例 如 ，HTML 的 部 分 代码 如 下 所 示 。 


<ul id="mylist"> 
<li class="red">java</1i> 
<1i class="red">python</1i> 
<1li class="red">c#</1i> 
<1Li class="red">ruby</1i> 
</ul> 


如 果 想 要 获取 Python 所 在 的 元 素 ， 则 需要 通过 如 下 代码 来 获取 此 元 素 。 

webdriver .find elements by class name ("red") [1] 

即 先 通过 find_elements_by_class_name 获取 到 所 有 匹配 的 元 素 ， 然 后 再 通过 索引 下 标 获 
取 第 2 个 元 素 (默认 下 标 从 0 开始 )。 
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3.5.3 ”匹配 非 第 一 个 元 素 


除了 通过 上 面 的 方法 来 处 理 同时 匹配 多 个 元 素 的 情况 ， 还 可 以 使 用 CSS 和 XPath 的 语 
法 功能 来 支持 选择 多 个 匹配 元 素 中 的 指定 元 素 ; 同样 以 3.5.2 节 的 HTML 为 例 看 看 CSS 和 
XPath 是 如 何 支 持 多 元 素 选 择 的 ， 首 先 来 看 CSS 的 代码 脚本 如 下 。 

webdriver.find element by css_selector('#mylist li:nth-child(1)') 

代码 中 关键 定位 符 为 :nth-child， 即 定位 元 素 中 的 第 几 个 孩子 节点 。 上 面 的 代码 的 意思 是 
定位 id 为 mylist 元素 下 的 第 1 个 孩子 节点 。 再 来 看 看 XPath 的 代码 脚本 如 下 。 

webdriver .find element by xpath('//*[@id="mylist"]/1i[1]') 

代码 中 通过 中 括 弧 中 的 数字 来 描述 具体 定位 第 几 个 孩子 节点 ， 上 面 的 代码 同样 是 定位 id 
为 mylist 的 元 素 下 第 1 个 1 孩子 节点 。 


注意 通常 情况 下 需要 定位 的 元 素 通过 上 面 提 到 的 方法 都 可 以 直接 定位 到 ; 而 另 一 些 时 
候 需 要 定位 的 元 素 却 没 有 任何 属性 ， 并 且 它 们 者 分布 在 整个 HTML 页面 内 ， 无 法 通过 以 上 方 
式 在 整个 HTML 页 面 内 定位 第 N 个 子 元 素 ; 这 时 通常 使 用 的 方法 就 是 寻找 它 的 可 定位 的 父 
类 元 素 ， 然 后 在 这 个 父 类 元 素 的 范围 内 进行 子 元 素 定位 。 


CHAPTER 


Selenium IDE 


Selenium IDE 是 Firefox 的 一 个 插件 ， 它 可 以 支持 对 页 面 上 的 测试 步 又 进行 录制 与 
即 可 以 通过 这 个 工具 进行 页 面 自 动 化 脚本 的 录制 ， 而 无 须 手动 开发 脚本 。 

默认 情况 下 ，Selenium IDE 录制 生成 的 是 HTML 表格 形式 的 测试 脚本 ; 回放 时 默认 也 是 
以 HTML UNIT 的 方式 回放 脚本 。 

此 外 ，Selenium IDE 还 有 一 个 特点 就 是 ， 它 可 以 把 HTML 形式 的 测试 脚本 转换 成 其 他 支 
持 Selenium 的 语言 脚本 。 例 如 ， 转 换 为 Python 语言 的 脚本 之 后 ， 再 通过 执行 Python 脚本 来 
达到 回放 的 效果 。Selenium IDE 支持 转换 的 脚本 语言 有 : C#、Java、Python、Ruby。 


也 


放 。 


4.1 Selenium IDE 安装 


Selenium IDE 的 安装 过 程 包括 Firefox 浏览 器 安装 、Selenium IDE 火狐 插件 的 安装 。 如 
果 本 机 已 经 安装 了 Firefox 浏览 器 ， 则 可 以 直接 跳 至 4.1.2 节 安 装 Selenium IDE 插件 。 


4.1.1 Firefox 安装 


由 于 Selenium IDE 是 Firefox 的 插件 ， 所 以 在 安装 Selenium IDE 之 前 需要 先 安装 一 下 
Firefox 浏览 器 。 具 体 的 安装 过 程 如 下 。 

(1 ) 进入 Firefox 官网 下 载 页 面 (http://www.firefox.com.cn/download/)。 

(2 ) 单 击 下 载 对 应 的 Firefox 版 本 。 
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〈3 ) 双击 下 载 的 exe 文件 。 
〈4 ) 默认 安装 或 选择 安装 目录 。 
(5 ) 依次 确认 完成 安装 。 


4.1.2 Selenium IDE 在 线 安装 


在 Firefox 安装 完成 之 后 ， 就 可 以 进行 Selenium IDE 的 安装 了 。 具 体 安装 步骤 如 下 。 

(1) 使 用 Firefox 打开 Selenium IDE 的 插件 下 载 页 面 (https://addons.mozilla.org/en-US/ 
firefox/addon/selenium-ide/) 。 

(2 ) 单 击 +Add to Firefox 按钮 ， 如 图 4-1 所 示 。 


Welcometo Firefox Add-ons. Choose from thousands of extra features and styles to make Firefox your own. x 


mp Selenium IDE 


re: 
to record, edit and deb 


图 4-1 Selenium IDE 插件 页 面 
(3 ) 单 击 Install 按钮 进行 安装 ， 如 图 4-2 所 示 。 
咱 Selenium IDE :: Add-ons... x 


所 办 


© A Mozilla Foundation (US) | https://addons.mozilla.org/en-US/firefox/addon/selenium-ide/ 
addons.mozilla.org 
This site would like to install an add-on in Firefox: 
Selenium IDE 


Learn more... 


GCC 


4-2 Selenium IDE 插件 安装 
(4 ) 安装 完成 后 重启 Firefox。 


(5 ) 按 一 下 Alt 键 一 单 击 Tools 菜单 栏 一 单 击 Selenium IDE 打开 IDE， 如 图 4-3 所 示 。 
〈6 ) 成 功 弹出 Selenium IDE 窗口 则 安装 成 功 ， 如 图 4-4 所 示 。 
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pr Selenium IDE 


2 


4-3 打开 Selenium IDE 


IT TT 
文件 E) 闹 锡 (日 Actions Options 帮助 
EL -J 
GE DEP | 0- 回 
Test Case | Table | Source 


Untitled 


Command Target Value 
| 


,| Command -| 
NN | To 


Runs: 9 
i 


En 


Value 


图 4-4 Selenium IDE 界面 
4.1.3 ”Selenium IDE 本 地 安装 


对 于 无 法 访问 Firefox 插件 官网 的 读者 ， 可 以 到 http://www.testqa.cn/download 下 载 最 新 
火狐 插件 ， 并 进行 本 地 安装 。 具 体 本 地 的 安装 步骤 如 下 。 
(1 ) 打开 Firefox 浏览 器 。 


(2 ) 按 一 下 Alt 键 一 单 击 Tools 菜单 栏 一 选择 “附加 组 件 ” 选 项 ， 如 图 4-5 所 示 。 


图 4-5 Firefox 附加 组 件 
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(3 ) 单 击 “ 配 置 ”按钮 ， 选 择 “ 从 文件 安装 附加 组 件 …”， 如 图 4-6 所 示 。 


办 附加 组 件 管理 器 
用 生理 类 


骨 yx 需 We 
yi 页 , 包 - Ee 


图 4-6 Firefox 本 地 安装 组 件 
(4) 浏览 下 载 到 本 地 的 Selenium IDE 安装 包 并 选择 ， 如 图 4-7 所 示 。 


图 4-7 选择 Selenium IDE 插件 包 
(5 ) 在 Firefox 提示 框 中 单 击 “ 安 装 ”， 如 图 4-8 所 示 。 


图 4-8 Selenium IDE 本 地 安装 


(6 ) 重启 Firefox 浏览 器 使 用 插件 安装 生效 ， 如 图 4-9 所 示 。 
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图 4-9 Selenium IDE 安装 确认 


(7) 按 下 Alt 键 一 单 击 Tools 菜单 栏 一 单 击 Selenium IDE 打开 IDE， 如 图 4-10 所 示 。 


这 i 
用 来 管理 火狐 的 阳 . 更 条 信息 


出 火 天 主页 ER 2 
火 甬 定制 主 页 , 包 .。 更 信息 

Selenium IDE 
留 weou eatan wor | ™ | 


图 4-10 打开 Selenium IDE 
(8 ) 正常 弹出 Selenium IDE 窗口 则 安装 成 功 ， 如 图 4-11 所 示 。 


Yeeniunoe2sl MN “el 


文件 日 篇 名 Actions Qptions 帮助 
Base URL | 加 
Ga gs |o @- 
Test Case Table LSource 
Untitled | 
| Command Target Value 

| Command Es = 一 = 2 
NN | Target | | Select Find 
Runs 0 | vaue | 
Failures 0 | 
| tog | Reference | UrElement | Rolup | Info- Clear 

| 


图 4-11 Selenium IDE 界面 


K< 
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4.2 Selenium IDE 功能 介绍 


Selenium IDE 安装 完成 之 后 ， 就 可 以 使 用 Selenium IDE 来 帮助 我 们 录制 测试 场景 ， 然 
后 转换 为 目标 语言 脚本 ， 这 里 为 Python 测试 脚本 。 通 过 这 种 方式 开发 测试 脚本 有 以 下 三 个 
好 处 。 

口 初 学 者 在 代码 基础 不 足 的 情况 下 仍 可 以 开发 自动 化 测试 脚本 。 

口 可 以 帮助 初学 者 了 解 并 学 习 Python 的 Selenium 脚本 样 例 。 

口 可 以 提 到 测试 脚本 的 开发 效率 。 

那么 ， 接 下 来 将 会 开始 对 Selenium IDE 的 基本 功能 进行 一 一 介绍 。 


4.2.1 Selenium IDE 窗口 


在 具体 进行 脚本 录制 之 前 ， 看 一 下 Selenium IDE 的 基本 功能 和 使 用 方法 。 按 照 4.1 节 的 
步骤 打开 Selenium IDE 窗口 ， 就 可 以 看 到 如 图 4-12 所 示 的 界面 。 


图 4-12 ”Selenium IDE 主 面板 区 域 


从 图 4-12 中 可 以 看 出 ，Selenium IDE 窗口 主要 由 以 下 几 个 区 域 组 成 。 
口 菜 单 栏 。 

口 地 址 栏 。 

口 工 具 栏 。 

口 用 例 管理 区 。 


口 用 例 脚 本 开发 区 。 
口 信息 输出 区 。 
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4.2.2 菜单 栏 


菜单 栏 包括 文件 、 编 辑 、Actions、Options、 帮 助 5 个 主 菜单 ， 其 中 ,“ 文 件 ” 菜 单子 项 
主要 用 来 管理 和 操作 测试 用 例文 件 。 例 如 ， 新 建 、 保 存 、 导 入 、 导 出 测试 用 例 /套件 文件 ， 
如 图 4-13 所 示 。 

“编辑 ”菜单 子 项 主要 用 来 对 测试 脚本 内 容 进行 编辑 。 例 如 ， 复 制 、 粘 贴 、 删 除 、 撤 销 、 
插入 等 操作 ， 如 图 4-14 所 示 。 


@ selevium DE 298 电 SeleniumIDE 29. 戎 
二 生日、Actons Options 帮助 = ~ - 

Now Tect Coce Cul+N 文件 (E) Actions Options 帮助 
Open- oho | Base UI 
Save Test Case 。 Chl+S 插销 (JU Cal+z 
er = EW Ctl+y 
ExportTestCase As » Tq 
Recent Tost Cases Test Ca 募 切 中 Ctrl+X 
AddTest Case-。 CultD Untitiel 复制 QO Ctrl+C 
Bm 烙 贴 Pp) CitV 
New Test Suite 
Open Testsute_ 删除 (D) Del 
Save Test Suite 
SR 全 全 选 (A) Ctrl+A 
Bs 
rn Insert New Command 
关闭 20 Cel+W E Insert New Comment 

图 4-13 Selenium IDE “文件 ”菜单 图 4-14 Selenium IDE“ 编 辑 ” 菜 单 


Actions 菜单 子 项 主要 用 来 控制 测试 脚本 开发 、 调 试 、 执 行 等 过 程 。 例 如 ， 录 制 、 回 放 、 
设置 断 点 、 控 制 回放 速度 等 ， 如 图 4-15 所 示 。 

Options 菜单 子 项 主要 用 来 设置 Selenium IDE 的 相关 配置 。 例 如 ， 全 局 设置 、 脚 本 格式 
设置 、 恢 复 设置 、 清 空 历史 等 ， 如 图 4-16 所 示 。 


| 本 ww Options- 


ET Fomet ， 


Test Case || [Tabe[s Clipboard Format » 
Untitled | ResetIDE Window 
Comm| Clear history » 
| | Schedule tests to run periodically 


图 4-15 Selenium IDE 的 Actions 菜单 图 4-16 Selenium IDE 的 Options 菜单 


其 中 大 部 分 的 IDE 设置 都 在 Options 子 菜单 中 ， 单 击 Options 子 菜单 会 弹出 一 个 设置 对 
话 框 ， 如 图 4-17 所 示 。 
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该 对 话 框 中 又 包括 : 通用 设置 、 格 式 设置 、 插 件 设置 、 定 位 器 生成 规则 设置 、WebDriver 
设置 。 这 里 面 常 用 的 设置 都 集中 在 通用 设置 、 格 式 设置 、 定 位 器 生成 规则 设置 之 中 。 
General 选项 卡 中 常规 设置 选项 说 明 如 图 4-18 所 示 。 


TREE [Eee 
General | Formats | Plugins [Locator Builders[ webDriver] 二 General Formats | Plugins [Locator Builders | wecbpriver| 
||| ncoding of ren fies | Encoding of test fles | 
UTF-S UF 保存 的 测试 文件 的 编码 格式 
Default timeout value of recorded command in milliseconds (30s = 30000ms) Defauht timeout value of recorded commend in milliseconds (30s = 30000ms) 
30000 | 30000 录制 命令 时 等 待 的 超时 时 间 ， 默 认 30 秒 
Selenium Core extensions (user-extensionsjs) | Selenium Cor extensions (user-extensions.js) 
== Browse— 下 至 Selenium Cors 的 功能 扩展 文 什 Browse~ 
Selenium IDE extensions Selenium IDE extensions 
| _Browse- | 鞍 择 Selenium IDE 闻 功能 扩展 文件 Browse-… 
| Tips for extensions Close and reopen Selenium IDE window to make d| Tips for extensions: Close and reopen Selenium IDE window to make changes 
offect. You can specify multiple files separated by commas. offect. You can specify multiple fles separated by commes. 
园 Remember base URL 财 Remember base URL 记 和 基础 URL 
EE Record assertTide eutomaticaly 同 Record assertTitle automatically 录制 时 自动 添加 标题 新 言 语句 
EE Record sbohite URL | 加 Record absolute URL 录制 时 使 用 绝对 URL 路 径 
用 © Activate developer tools 目 Activate developer tools 开启 开发 者 工具 
EE) Visual assist (restart of Selenium IDE is required) 加 Visual aesist (restart of Selenium IDE is required) 
门 Enable experimental features Enable experimental features 
EE Disable format change warning messages 目 Dicsble fcrmat change warning mescages 格式 改变 时 不 提示 警告 
Start recording immediately on open Siart recording immediately en open 打开 1DE 时 启动 录制 
Reset Options | 取 商 [Roset Opbons ME | Ww | 
= 一 
图 4-17 Selenium IDE 选项 设置 图 4-18 Selenium IDE 通用 选项 说 明 


Formats 选项 卡 中 选项 主要 用 来 设置 不 同 语言 格式 脚本 的 模板 变量 设置 ， 如 文件 名 、 包 
名 、WebDriver 实例 的 变量 名 、Remote WebDriver 的 连接 信息 等 ， 如 图 4-19 所 示 。 


图 4-19 Selenium IDE 格式 选项 设置 
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Locator Builders 选项 卡 则 用 来 设置 定位 器 生成 规则 的 优先 级 。 默 认定 位 规则 优先 级 顺序 
如 图 4-20 所 示 ， 并 且 可 以 通过 拖 放 子 选 项 来 改变 其 默认 的 优先 级 顺序 。 


Formats [Plugins | Locator Builders | WebDriver 


Drag and drop the locator builders on the left to change their order 


图 4-20 Selenium IDE 定位 器 格式 设置 


“帮助 ”菜单 子 项 主要 与 Selenium IDE 帮助 相关 ， 例如， 帮助 文档 、 问 题 反 馈 、 官 网 地 
址 等 ， 如 图 4-21 所 示 。 


瑟 SeleniumlDE291 = 
BaseuURL Documentation 
一 ULElement Documentation 
Test Case Table | Source Report Issue 
Untitled Search lssues 

sil Submit Disgnostic Information 
| Release Notes 
Official Selenium Blog 
Official Selenium Website 


图 4-21 Selenium IDE“ 帮 助 ”菜单 


4.2.3 地址 栏 


Selenium IDE 的 地 址 栏 主要 用 来 设置 被 测 应 用 的 基础 URL 地 址 ; 设置 了 该 地 址 之 后 ， 
测试 脚本 中 使 用 到 URL 的 步骤 都 可 以 使 用 基于 该 基础 URL 的 相对 路 径 。 

例如 ， 正 常 访问 知 乎 的 问答 页 面 其 完整 URL 为 https://www.zhihu.com/question/41541192， 
现在 我 们 在 Selenium IDE 的 地 址 栏 中 输入 基础 URL 为 https://www.zhihu.com， 则 测试 脚本 中 
访问 该 问题 页 面 时 ， 只 需 输入 /question/41541192 路 径 即 可 。 如 果 使 用 的 是 录制 的 方式 开发 
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测试 脚本 ， 则 默认 会 生成 相对 URL 路 径 。 


4.2.4 工具 栏 


工具 栏 中 的 按钮 和 选项 ， 其 实 都 是 Actions 主 菜单 中 的 快捷 键 。 各 按键 的 功能 说 明 如 表 
4-1 所 示 。 


表 4-1 Selenium IDE 工具 栏 按键 说 明 
按键 图 标 按钮 名 称 说 明 


CE 速度 控制 器 用 来 控制 测试 脚本 执行 速度 
P| 测试 套件 执行 器 用 来 执行 整个 测试 套件 
CE 测试 用 例 执行 器 用 来 执行 当前 测试 用 例 


[ED 暂停 /恢复 执行 在 测试 执行 过 程 中 暂停 和 恢复 执行 


单 步调 试 器 在 调试 模式 下 执行 单 步 脚本 执行 
@ 测试 脚本 重 载 当 测试 脚本 文件 在 外 部 被 修改 时 重 载 变化 内 容 


测试 步骤 归档 把 多 个 测试 步骤 集合 为 一 个 action 操作 


i 
I© 录制 /取消 录制 启动 录制 /取消 录制 


四 - 测试 任务 调度 器 配置 定时 执行 测试 任务 


如 


4.2.5 ”用 例 管理 区 


用 例 管理 区 主要 用 来 管理 测试 用 例 ， 例 如 ， 新 建 测试 用 例 、 添 加 已 有 测试 用 例 、 删 除 测 
试用 例 等 。 该 区 域 的 所 有 测试 用 例 集合 在 一 起 就 是 一 个 测试 套件 ， 并 且 同 时 只 能 打开 一 个 测 
试 套件 进行 用 例 管理 。 如 果 需 要 管理 另 一 个 测试 套件 中 的 用 例 ， 那 么 就 需要 打开 一 个 新 的 测 
试 套件 来 覆盖 当前 测试 套件 中 的 内 容 。 

对 于 自动 化 测试 用 例 数 较 少 的 应 用 而 言 ， 可 以 把 所 有 的 测试 用 例 都 存在 一 个 测试 套件 
中 ， 最 终 会 保存 在 一 个 HTML 文件 中 。 而 对 于 用 例 数 较 多 的 应 用 来 讲 ， 应 该 按 功 能 划分 多 
个 测试 套件 ， 每 一 个 功能 都 应 该 有 一 个 自己 的 套件 ， 最 终 用 例会 按照 套件 分 别 保存 在 不 同 的 
HTML 文件 中 。 

用 例 管理 区 中 的 用 例 可 以 有 两 种 方式 进行 管理 : 一 种 是 直接 右 击 该 区 域 ， 在 弹出 的 菜单 
中 有 管理 用 例 的 选项 ， 包 括 新 建 、 添 加 、 删 除 、 执 行 、 编 辑 等 操作 ， 如 图 4-22 所 示 。 
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另 一 种 管理 用 例 的 方式 为 ， 单 击 “ 文 件 ”菜单 栏 ， 在 其 子 菜单 中 也 有 用 例 管理 的 相关 选 
项 ， 如 图 4-23 所 示 。 


@ Untitled 2 (untitled suite) - Selenium iDi 


Save TestCase Ctrl+S 


New Test Case | ctrHN 
Open- CultO J 
able |s 


Add Test Case.. Ctrl+D 
Properties… 

New Test Suite 

Open Test Suite_ 

Save Test Suite 

Save Test Suite As 
Export Test Suite As.. » | Targo 
Recent Test Suites » | vaue 
关闭 00 


图 4-22 Selenium IDE 用 例 编辑 图 4-23 Selenium IDE 新 建 用 例 操作 


Comnl 


Ctl+W 


4.2.6 ”用 例 脚本 开发 区 


用 例 脚本 开发 区 主要 是 编辑 测试 用 例 的 具体 步骤 。 通 过 单 击 用 例 管理 区 中 的 测试 用 例 
名 ， 就 可 以 在 用 例 脚本 区 查看 该 测试 用 例 的 脚本 内 容 。 该 区 域 有 两 种 编辑 模式 : 表格 编辑 模 
式 ， 源 码 编辑 模式 。 

表格 编辑 模式 为 推荐 的 编辑 模式 ， 在 这 种 模式 下 ， 它 可 以 为 脚本 开发 提供 一 些 帮助 。 例 
如 ， 提 供 测 试 命令 的 选择 、 测 试 对 象 的 拾取 帮助 等 。 如 图 4-24 所 示 为 表格 模式 的 功能 介绍 。 


Table [Source 


Target 


测试 步骤 显示 列表 


| command 款 仿 洁 泽 栏 ， 提供 动态 适 画 帮 有 - 
Target ”测试 目标 定位 栏 Select Find 


Value 命令 参数 值 测试 目标 定位 帮助 


图 4-24 Selenium IDE 表格 脚本 开发 区 
源码 编辑 模式 为 备 选 的 编辑 模式 ， 在 特定 的 场景 下 使 用 会 有 不 同 的 效果 。 例 如 ， 批 量 复 


制 /粘贴 、 批 量 修改 /替换 用 例 内 容 等 。 此 类 场景 可 以 在 源码 编辑 模式 下 把 脚本 内 容 复 制 到 
外 部 编辑 器 中 ， 在 操作 完 相 关内 容 之 后 ， 再 粘贴 到 源码 编辑 器 中 即 可 。 如 图 4-25 所 示 为 源码 
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编辑 模式 时 HTML 格式 的 样 例 内 容 。 


区 ee] source| 


Pxnl version="1.0” encoding="UTP-8"?> 
<IDOCTYPE htnl PUBLIC ~ Re XL 1.0 So “http: /fm. 3 
n> 


| 


ee 
UTP-8" /> 


table cellpadding="1” cellspacing="1” border="1"> 
thead> 


Ctr >td rowspan="1” colspan="3" ew Test Otay/tr> 
thead>Ctbody> 
tr> 二 


图 4-25 Selenium IDE 源码 脚本 开发 区 


4.2.7 ”信息 输出 区 

信息 输出 区 主要 用 来 回 显 各 种 输出 信息 。 例 如 ， 测 试 日 志 、 命 令 参考 文档 、UI-Element 
定义 文档 、Rollup 定义 文档 。 只 有 测试 日 志 是 在 执行 用 例 时 才 会 有 输出 ， 其 日 志 等 级 包括 
debug 、info、warm 、error， 默 认 等 级 为 info。 其 他 三 个 都 是 用 来 回 显 特定 对 象 的 帮助 文档 的 ， 
如 图 4-26 所 示 。 


| | linfo] Plaving test case Untitied 2 
[info] Executing: ldick [id=kw [| 

| [error] Elementid=kw not found 
[info] Test case failed 

| [info] Playing test case Untited 2 

| [info] Executing: cick | id=kw | | 
[info] Executing: lopen | _blank | | 
[info] Test case passed 


图 4-26 ”Selenium IDE 日 志 等 级 设置 


4.3 ”Selenium IDE 使 用 
在 介绍 完 Selenium IDE 所 具有 的 基本 功能 之 后 ， 就 可 以 开始 学 习 使 用 Selenium IDE 开 
发 测试 脚本 了 。 本 节 主 要 包括 录制 脚本 、 编 辑 脚本 、 回 放 脚 本 、 调 试 脚本 、 转 换 脚 本 等 。 


4.3.1 Selenium IDE 录制 与 回放 


这 里 以 一 个 百度 首页 搜索 关键 字 的 操作 场景 为 例 ， 来 进行 一 次 测试 脚本 的 录制 ,具体 过 
程 如 下 。 


(1 ) 打开 Firefox 浏览 器 。 
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(2 ) 菜单 栏 单 击 “ 工 具 ” 主 菜单 。 

(3 ) 选择 Selenium IDE 子 菜单 。 

(4 ) 单 击 回 按 钮 开始 录制 (如 果 上 默认 没有 启动 录制 )。 

(5 ) 在 Firefox 浏览 器 中 输入 URL (http://www.baidu.com)。 
(6 ) 在 百度 搜索 框 中 输入 “Selenium IDE” 并 回 车 。 


(7 ) 单 击 图 按钮 停止 录制 。 
(8 ) 单 击 豆 按钮 进行 回放 。 
(9 ) Firefox 浏览 器 就 会 自动 


回放 录制 的 场景 。 


2? 


注意 ”Selenium IDE 默认 不 会 录制 Firefox 浏览 器 的 关闭 事件 ， 同 时 在 回放 HTML UNIT 
的 时 候 也 不 会 启动 Firefox ; 所 以 场景 操作 最 后 无 须 关 闭 Firefox 浏览 器 ， 否 则 回放 将 会 提示 


错误 。 


现在 来 看 下 Selenium IDE 录制 的 脚本 是 什么 样 ， 如 图 4-27 所 示 。 


8 


Selenium IDE 


(ese) 区 se 


图 4-27 Selenium IDE 录制 脚本 


从 图 4-27 中 可 以 看 到 录制 的 内 容 以 表格 形式 展示 ， 表 格 的 每 一 行 代表 用 户 的 一 个 操作 
或 是 验证 ， 并 且 不 难看 出 这 5 个 步骤 分 别 如 下 。 


(1) 打开 百度 首页 。 


〈2 ) 验证 页 面 标题 为 “百度 一 下 ， 你 就 知道 ”。 


(3 ) 单 击 id 为 kw 的 元 素 。 


(4) 在 id 为 kw 的 元 素 里 输入 “Selenium ”字符 串 。 


(5 ) 单 击 id 为 su 的 元 素 。 


其 中 ，id 为 kw 的 元 素 就 是 百度 的 输入 框 ， 而 id 为 su 的 元 素 就 是 百度 的 搜索 按钮 。 可 
以 使 用 Firefox 的 开发 者 工具 来 查看 ， 步 又 如 下 。 
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(1) 在 Firefox 地 址 栏 中 输入 http://www.baidu.com。 
(2 ) 右 击 搜索 输入 框 ， 单 击 Inspect Element， 如 图 4-28 所 示 。 


Show All Available Commands 


图 4-28 Firefox 查看 元 素 


(3 ) 在 底部 的 弹出 窗 格 中 找到 有 背景 色 的 节点 ， 并 查看 其 id 属性 即 为 kw， 如 图 4-29 
所 示 。 


加 Console ©@ Debugger {} Style Editor 四 Performan... 


《 wrapper » divsform » divs form_wrappersoutu-eny-nomacsoutu.、 > form#formfm » sp| 


图 4-29 Firefox 查看 元 素 内 容 
(4) 同样 的 操作 可 以 查看 “搜索 ”按钮 的 id 为 su。 


4.3.2 Selenium IDE 脚本 编辑 


4.3.1 节 中 是 通过 录制 的 方式 来 开发 测试 用 例 的 。 其 实 除了 录制 还 可 以 通过 人 工 添加 测试 
步 又 的 方式 来 开发 测试 用 例 ， 此外， 还 可 以 对 录制 的 测试 脚本 进行 编辑 和 修改 ， 以 达到 最 终 
的 测试 场景 要 求 。 

1. 添加 一 个 测试 步骤 

在 Selenium IDE 中 添加 一 个 测试 步骤 的 流程 如 下 。 

(1) 打开 Selenium IDE。 

(2 ) 在 脚本 开发 区 空白 处 右 击 ， 如 图 4-30 所 示 。 


第 4 章 Selenium IDE && 129 


(3 ) 选择 菜单 中 的 Insert New Command。 

(4) 在 Command 输入 框 中 输入 一 个 操作 命令 ， 如 “type”。 

(5 ) 在 Target 输入 框 中 输入 一 个 元 素 定位 符 ， 如 “id=kw”。 

(6) 在 Value 输入 框 中 输入 一 个 命令 参数 值 ， 如 “Selenium IDE”， 如 图 4-31 所 示 。 


@ nided 2 nided wilaselerin DE 291 "8 (= @ untied 2 ntited iogseltnin DE 291 "ss (e+e | 
Base URL https//www.baiducom/ Base URL httpe//www baiducom/ Fy 
CE gs SI0@ 9- 回 EL as ee @ - 回 
Table[seuree Tabie | Source]| 

i 


Command 


clearAll = 
Tuina 6 lia 
Set/ Clear Start Point S$ 
Execute this command X 


Target 


Target 


id=kw 
Value 


Value SeleniumIDE 


L 


图 4-30 Selenium IDE 插入 步骤 图 4-31 Selenium IDE 步 双 编辑 1 


在 上 面 的 几 个 步骤 完成 之 后 ， 在 百度 搜索 框 中 添加 了 一 个 输入 “ Selenium IDE” 关 键 字 
的 测试 步骤 。 
2. 编辑 一 个 测试 步骤 


同 添加 一 个 测试 步骤 的 操作 不 同 的 是 ， 编 辑 测试 步骤 时 需要 先 选择 一 个 已 有 的 测试 步 


又 ， 然 后 再 对 该 步 又 的 内 容 进 行 修改 。 例 如 ， 针 对 4.3.1 节 中 录制 的 脚本 ， 把 关键 字 修改 为 
“Python” 的 操作 流程 如 下 。 


(1) 用 鼠标 选中 要 修改 的 步 又， 如 图 4-32 所 示 。 
(2 ) 在 Value 输入 框 中 把 值 修改 为 “Python”， 如 图 4-33 所 示 。 


United 2 rtided su seriun DE 291 "BS [em | 
文件 四” 各 二 四 Acions Qption 大 有 
ps/ ww Desc conV 


Cs pas SIR 0 - 回 
Teoh 


cd GE 
a | 


we [ae 


van 


图 4-33 Selenium IDE 步骤 编辑 3 


图 4-32 Selenium IDE 步 又 编辑 2 
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同样 地 ， 还 可 以 修改 Command、Target 输入 框 中 的 内 容 。 此 外 ， 对 于 测试 用 例 步 又 还 可 
以 进行 复制 、 粘 贴 、 删 除 等 操作 ;如 果 想 要 使 用 这 些 操 作 ， 只 要 打开 右键 菜单 即 可 看 到 ， 如 
图 4-34 所 示 。 


3. 添加 一 个 注释 

在 测试 脚本 中 ， 对 于 有 些 不 太 好 理解 的 测试 步骤 ， 可 能 就 需要 添加 一 些 注释 ， 来 提高 测 
试 脚本 的 可 读 性 。 而 在 Selenium IDE 中 也 提供 了 添加 注释 的 功能 ， 具 体 步 又 如 下 。 
(1 ) 选择 需要 注释 的 测试 步骤 并 右 击 。 
(2 ) 选择 菜单 中 的 Insert New Comment， 如 图 4-35 所 示 。 


@ United Znided wiiolgselerin BE 381" 二 
帮助 


(HT TT 
em | 


@ -ee 
i | 
sr 全 
assertTi 
Copy Ctrl+C 
风 疯 Paste cutv 
2 Delete 
dlick 
Insert New Command Insert New Command 
te 
Command op: Clear Al 
sa i ESTEPSSTEER 
be Set/ Clear Start Point S Set/ Clear Start Point S 


Execute this command X 


| 2 Execute this command X 
图 4-34 Selenium IDE 步骤 编辑 4 图 4-35 Selenium IDE 步骤 编辑 5 

(3 ) 选择 新 插入 的 空 测试 步 又 。 

(4) 在 Command 输入 框 中 输入 备注 内 容 ， 如 图 4-36 所 示 。 


4. 添加 一 个 检查 点 

在 上 面 demo 场景 中 只 有 用 户 操作 ， 而 实际 的 测试 场景 中 除了 用 户 操作 外 ， 更 重要 的 则 
是 测试 结果 的 检查 与 验证 。 在 Selenium IDE 中 添加 检查 点 的 方式 有 两 种 : 一 种 是 通过 添加 测 
试 步 又 的 方式 添加 一 条 验证 命令 ， 另 一 种 是 在 录制 过 程 中 通过 页 面 操作 来 添加 。 

首先 来 看 下 如 何 通过 添加 步骤 的 方式 来 添加 检查 点 。 这 里 以 4.3.1 节 中 录制 的 测试 脚本 
场景 为 基础 ， 检 查 搜 索 之 后 浏览 器 标题 是 否 包 含 “ Selenium IDE” 字 样 。 具 体 添 加 检查 点 的 
步骤 如 下 。 

(1 ) 在 单 击 搜索 步骤 之 后 右 击 ， 如 图 4-37 所 示 。 

(2 ) 选择 Insert New Command 子 项 ， 如 图 4-38 所 示 。 

(3 ) 在 Command 输入 框 中 输入 “assertTitle”( 验证 title 的 验证 点 函数 )。 
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ri i [CT 
文件 日 帝 得 日 Actions Options 帮助 


Base URL https//www.baidu.com/ 


ee babs IG OQ- 
Ta 
Value Command Te Value | 
open, 
paicke 入 kw 单 击 搜索 的 步 又 
yp d=kw PA Selenium IDE 


|| cormand [Eran | 
Target | | select 


Value | 


图 4-36 Selenium IDE 步 又 编辑 6 


图 4-37 ”Selenium IDE 步 又 编辑 7 
(4) 在 Target 输入 框 中 输入 “Selenium IDE”， 如 图 4-39 所 示 。 


Untitled 2 (untitled suitej - Selerium IDE 291 
文件 四 病 朋 日 Actions Options 部 且 
Bace URL httpe//www baidu.com/ 


Cs Paps | ooe 


| 


文件 日 坊 弓 下 Actons Options 必 助 


Base URL https//www.baiducom/ 


a Se ee | 


Target Value 


| 
日 
Selenium IDE 


| Command [ assertTitie = 
Target Selenium IDE Seled Find 


Command dearall 


Target Toogle Breatpont 日 
Ni Sot /Clear Start point 和 
Execute this command X 


图 4-38 Selenium IDE 步骤 编辑 8 图 4-39 Selenium IDE 步骤 编辑 9 


通过 上 述 几 个 步骤 可 以 知道 ， 在 Selenium IDE 中 检查 点 其 实 也 是 一 个 标准 的 测试 步 又 。 


并 且 在 Selenium IDE 的 命令 中 以 assert 开头 的 都 是 检查 点 命令 ， 只 是 检查 的 对 象 不 同 而 已 。 
常用 的 检查 点 命令 有 assertTitle 、assertValue 、assertText、assertAttribute 等 。 


在 完成 了 添加 检查 点 之 后 ， 还 需要 通过 运行 脚本 来 确定 检查 点 能 了 
例 的 步骤 如 下 。 


(1 ) 单 击 融 按钮 执行 当前 测试 用 例 。 
(2 ) 查看 测试 执行 日 志 ， 如 图 4-40 所 示 。 


从 图 4-40 中 的 测试 日 志 结 果 得 知 ， 本 次 执行 的 检查 点 验证 失败 。 失 败 的 原因 为 : 实际 结 


E 常 工作 。 运 行 测试 用 
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果 为 “百度 一 下 ， 你 就 知道 ”， 而 期 望 结 果 是 “Selenium IDE”。 


| tog | Reference | ULElement | Rollup | 


Jnfo- 


[info] Executing: |open | /11 
[info] Executing: ldick | id=kw | | 


[info] Executing: |dick | id=su | | 


IDE' 
[info] Test case failed 


[info] Playing test case Untitled 2 


[info] Executing: |type | id=kw | Selenium IDE | 


[info] Executing: |assertTitie | Selenium IDE | | 
[error] Actual value "百度 一 下 ,你 就 知道 " did not match ‘Selenium 


图 4-40 Selenium IDE 日 志 打印 


分 析 之 后 可 以 知道 ,“ 百 度 一 下 ， 你 就 知道 ”其 实 是 首页 的 标题 ， 即 我 们 期 望 检 查 的 是 
单 击 搜索 之 后 的 页 面 标题 ， 而 测试 脚本 实际 上 是 取 到 了 单 击 搜索 之 前 的 页 面 标题 来 验证 。 而 
导致 这 种 情况 出 现 的 原因 也 非常 常见 ， 即 脚本 并 没有 等 待 页 面 跳 转 完成 ， 就 开始 执行 了 检查 


点 命令 。 


为 了 解决 等 待 页 面 跳 转 的 问题 ， 需 要 在 检查 点 步骤 之 前 ， 添 加 一 个 等 待命 令 。 在 Selenium 
IDE 中 等 待命 令 有 两 类 : 一 类 是 等 待 固定 时 长 的 等 待命 令 ， 一 类 是 最 大 超时 的 等 待命 令 。 

前 者 每 次 执行 都 会 等 待 一 个 固定 时 长 ， 例 如 5s。 后 者 每 次 执行 会 在 超时 时 间 内 等 待 一 个 
条 件 ， 例 如 ， 某 个 特定 元 素 的 出 现 ; 一 旦 条 件 满足 则 退出 等 待 ， 如 果 达 到 超时 时 间 仍 未 满足 ， 
也 会 取消 等 待 。 很 明显 ， 后 者 的 等 待命 令 更 加 适合 本 次 的 场景 ， 为 此 我 们 添加 一 个 等 待 元 素 


出 现 的 命令 。 详 细 步 又 如 下 。 
(1) 在 检查 点 测试 步 又 上 右 击 。 
(2 ) 选择 Insert New Command。 


(3 ) 在 Command 输入 框 中 输入 “waitForElementPresent”。 


(4) 在 Target 输入 框 中 输入 “link= 下 一 页 >” (结果 页 中 的 下 一 页 )， 如 图 4-41 所 示 。 


Table Source| 
Command Target 
打开 百度 首页 
open / 
dlick id=kw 


Value 


Selenium IDE 


图 4-41 Selenium IDE 步 又 编辑 10 
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接着 ， 再 次 执行 一 下 当前 测试 脚本 ， 并 查看 其 结果 日 志 如 图 4-42 所 示 。 


Log | Reference | ULElement | Rollup Info” Clear 


[info] Playing test case Untitled 2 二 
[info] Executing: lopen | /11 

[info] Executing: |dick | id=kw | | 

[info] Executing: ltype | id=kw | Selenium IDE | 

[info] Executing: |dick | id=su | | 

[info] Executing: |waitForElementPresent | link= 下 一 页 > | | 

[info] Executing: |assertTitie | Selenium IDE | | 

[error] Actual value ‘Selenium IDE_ 百 度 搜索 did not match 
‘Selenium IDE' 国 | 
[info] Test case failed =| 


图 4-42 Selenium IDE 错误 日 志 打 印 


从 图 中 结果 可 以 看 到 ， 这 次 执行 检查 点 有 验证 失败 了 。 而 这 次 错误 的 原因 已 不 再 是 取得 
的 浏览 器 标题 错误 ， 而 是 实际 结果 与 期 望 结 果 不 一 致 。 期 望 结果 是 “Selenium IDE”， 实 际 结 
果 是 “Selenium IDE 百度 搜索 ”。 

因为 实际 结果 并 没有 错 ， 所 以 针对 这 种 结果 的 错误 ， 就 可 以 通过 修改 期 望 结果 值 来 解 
决 。 修 改期 望 结果 值 可 以 有 两 种 方式 : 一 种 是 修改 成 完全 匹配 的 内 容 ， 如 “ Selenium IDE_ 
百度 搜索 ”; 另 一 种 是 修改 成 模糊 匹配 的 内 容 ， 如 “Selenium IDE*”。 

修改 完 期 望 结果 值 之 后 ， 再 执行 一 次 当前 脚本 。 查 看 运行 日 志 时 ， 其 检查 点 已 经 验证 通 
过 了 。 结 果 如 图 4-43 所 示 。 


Table | Source 
Command Target Value 
打开 百度 首页 E 
川 om / | 
P| dick id=kw 
||| ltype id=kw Selenium IDE | 
dick id=su 
waitForElementpresent 。 link= 下 一 页 > 
| 


Command assertTitle = 
Target Selenium IDE| Select Find 
Value 本 


[info] Executing: ltype | id=kw | Selenium IDE | 
[info] Executing: ldick | id=su | | 
[info] Executing: |waitForElementpresent | link= 下 一 页 > | | 


info] Executing: |assertTitie | Selenium IDE= | | 国 | 
[info] Test case passed 二 


4-43 Selenium IDE 通过 日 志 打印 
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接 下 来 ， 再 看 看 如 何 通过 页 面 操作 ， 在 Selenium IDE 中 添加 检查 点 。 基 于 4.3.1 节 的 录 
制 脚本 ， 具 体操 作 步 骤 如 下 。 

(1 ) 右 击 百度 搜索 结果 页 面 。 

(2 ) 选择 Show All Available Commands， 如 图 4-44 所 示 。 


open /s?ie=utf-8&f=8&rsv_bp=08rsv_idx=l8&tn=baidu&wd=Selenium%20… 
ysrifyyah 


图 4-44 Selenium IDE 可 用 命令 查看 


(3 ) 单 击 “assertTitle Selenium IDE 百度 搜索 ”"， 如 图 4-45 所 示 。 


open /s?ie=utf-8&f=88ursv_bp=0&rsv_idx=1&tn=baiduBwd=Selenium%20... 
assertValue 
assertText css=div.head_nums_cont_inner 收 起 工具 所 有 网 页 时 间 不 限 所 有 网 页 … 
assertTable 
assertElementPresent css=div.head_nums_cont_inner 
verifyTitle Selenium IDE 百度 搜索 
verifyValue 
verifyText css=div.head_nums_cont_inner 收 起 工具 所 有 网 页 时 间 不 限 所 有 网 页 … 
verifyTable 
verifyElementPresent css=div.head_nums_cont_inner 
waitForTitle Selenium IDE_ 百 度 搜 索 
waitForValue 
waitForText css=div.head_nums_cont_inner 收 起 工具 所 有 网 页 时 间 不 限 所 有 网 … 
waitForTable 
‘waitForElementPresent css=div.head_nums_cont_inner 
storeTitle Selenium IDE 百度 搜索 
storeValue 


storeText css=div.head_nums_cont_inner 收 起 工具 所 有 网 页 时 间 不 限 所 有 网 页 … 
storeTable 
storeElementpresent css=div.head_nums_cont_inner 


图 4-45 Selenium IDE 断言 步骤 插入 


(4) 查看 Selenium IDE 中 的 录制 步骤 ， 发 现 新 增 了 一 行 检查 点 的 表格 记录 ， 如 图 4-46 
所 示 。 

同样 的 步骤 还 可 以 添加 其 他 的 测试 场景 需求 ， 如 verifyTitle、waitForTitle、storeTitle 等 。 

其 中 ，verifyTitle 也 是 检查 浏览 器 标题 是 否 匹配 期 望 结 果 ， 它 与 assertTitle 不 同 的 是 : 
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assertTitle 失败 后 会 退出 当前 用 例 执行 ， 而 verifyTitle 失败 后 虽然 会 提示 错误 ， 但 仍 会 继续 执 
行 后 续 测 试 步骤。 


Table | Source | 
Command Target Value 
打开 百度 首页 
open / 

P| jdick id=kw 
type id=kw Selenium IDE 
click id=su 


Command ”打开 百度 首页 
Target Select Find 


Value 


图 4-46 Selenium IDE 断言 步 又 


而 waitForTitle 则 是 一 个 同步 检查 点 的 命令 ， 与 前 面 使 用 到 的 waitForElementPresent 
命令 效果 类 似 。 它 会 等 待 特定 的 浏览 器 标题 出 现 ， 一 旦 出 现 就 不 再 等 待 ; 否则 一 直 等 待 到 
超时 时 间 。 与 assertTitle 命令 的 区 别 是 : waitForTitle 命令 即使 等 待 失败 也 不 会 有 任何 信息 
提示 。 


提示 文中 提 到 的 assert*、verify*、waitFor* 这 三 类 检查 点 命令 ， 在 常规 的 测试 场景 中 
会 被 经 常 性 地 使 用 到 ， 读 者 需要 明确 地 理解 这 三 类 检查 点 的 不 同 之 处 ， 才 能 恰当 地 在 测试 脚 
本 中 来 使 用 它们 。 


5. 添加 一 个 断 点 

在 前 面 的 测试 脚本 开发 过 程 中 ， 调 试 测试 脚本 都 是 通过 正常 执行 测试 用 例 来 完成 的 。 但 
是 某 些 情况 下 ， 正 常 执行 测试 用 例 并 不 利于 调查 测试 失败 的 原因 。 此 时 就 需要 更 多 的 调试 手 
段 来 支持 ,在 Selenium IDE 中 就 可 以 通过 设置 “ 断 点 ”来 增强 脚本 调试 能 力 。 

同样 地 ， 这 里 以 4.3.1 节录 制 的 脚本 为 基础 ， 添 加 一 个 调试 断 点 的 步骤 如 下 。 

(1) 右 击 需 要 设置 断 点 的 步 又 。 

(2 ) 选择 Toggle Breakpoint 子 项 ， 如 图 4-47 所 示 。 

(3 ) 查看 断 点 设置 是 否 成 功 ， 如 图 4-48 所 示 。 

在 成 功 设置 “ 断 点 ”之 后 ， 再 次 执行 当前 脚本 时 ， 当 执行 到 设置 了 “ 断 点 ”的 步 又 时 ， 
测试 执行 就 会 被 暂停 。 此 时 ， 就 可 以 有 充足 的 时 间 来 分 析 页 面 内 容 ， 检 查 是 否 与 当前 测试 场 
景 上 下 文 一 致 。 
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Table [source 
| command Target Value 
ee 
a / 
liek id=kw 
ype id=kw Selenium IDE 


Set/ Clear Start Point 5 


| i 
id=kw 
[ma id=su 
| 断 点 设置 成 功 


Execute this command X 


Selenium IDE 


Command 


[Seed_ | | Fnd 


图 4-47 Selenium IDE 断 点 插入 


图 4-48 Selenium IDE 断 点 插入 成 功 


当 测 试 执行 在 “ 断 点 ”处 被 暂停 时 ， 可 以 有 两 种 方式 来 继续 执行 测试 场景 。 
(1) 单 击 刘 按钮 继续 执行 后 续 步 又 ， 直 到 下 一 个 “ 断 点 ”或 测试 结束 。 
(2 ) 单 击 号 | 按钮 仅 执 行当 前 步骤 ， 并 在 下 一 步骤 中 暂停 。 


在 测试 脚本 调试 完成 之 后 ， 需 要 取消 “ 断 点 ”时 。 其 操作 步骤 与 设置 “ 断 点 ”是 一 样 的 。 


具体 如 下 。 
(1 ) 右 击 准备 取消 “ 断 点 ”的 步 又 。 
(2 ) 选择 Toggle Breakpoint 子 项 ， 如 图 4-49 所 示 。 
(3 ) 检查 “ 断 点 ”是 否 取消 成 功 ， 如 图 4-50 所 示 。 


Table source| = 


Table | Source 
Command Target Value 
打开 百度 首页 
】 | open 7 
全 dlick ees 
Be RR ype id=kw Selenium IDE 
| Delete Del ek id=su 
Comma 
Target | Insert New Command 
Insert New Comment 
Value 
ClearAll Command 可 让 
Target id=su » [select Find 
oalins sr Vibe 
<click(locd 。 Execute this command X esl | 


钮 即 


图 4-49 Selenium 断 点 取消 


图 4-50 SeleniumIDE 断 点 取消 成 功 


而 当 测试 脚本 正在 执行 中 ， 我 们 希望 进入 到 “ 断 点 ”场景 时 ， 只 要 单 击 工具 栏 中 的 而 按 


可 。 
此 外 , 在 Selenium IDE 中 除了 设置 其 点" 来 调试 脚本 之 外 ， 还 可 以 通过 执行 和 


外 条 命令 
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设置 起 始 执行 步 又 等 方式 来 协助 脚本 的 测试 过 程 。 后 两 种 方式 的 使 用 人口 与 “ 断 点 ”设置 一 
样 ， 直 接 右 击 具体 的 测试 步骤 即 可 看 到 。 具 体 如 图 4-51 所 示 。 

最 后 来 讲 下 Selenium IDE 的 调试 功能 具体 在 哪些 场景 下 使 用 。 这 里 以 之 前 添加 检查 点 小 
节 中 验证 失败 的 场景 为 例 ， 来 介绍 如 何 使 用 调试 功能 来 分 析 问 题 。 此 前 验证 检查 点 失败 时 的 


步 又 与 日 志 如 图 4-52 所 示 。 


Table [Source 


Command 
打开 百度 首页 


图 4-51 ”Selenium IDE 单 步 执 行 


图 4-52” ”Selenium IDE 验证 失败 
当 我 们 遇 到 类 似 问 题 时 ， 首 先 要 考虑 的 是 获取 实际 结果 时 的 上 下 文 场景 是 否 正确 。 而 在 


正常 执行 测试 脚本 时 ， 无 法 在 较 短 的 时 间 内 确认 上 下 文 内 容 是 否 正确 。 此 时 就 可 以 在 验证 点 
这 一 步骤 设置 一 个 “ 断 点 ”， 并 再 次 执行 测试 脚本 ， 如 图 4-53 所 示 。 


ro 
info] 

[info] Executing: ldick | id=kw | | 
info] Executing: ltype | id=kw | Selenium 1DE | 
[info] Executing: ldick | id=su | | 


图 4-53” Selenium IDE 单 步调 试 
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当 脚 本 执行 到 检查 点 步骤 时 ,测试 执行 被 暂停 。 此 时 就 可 以 检查 实际 页 面 上 的 标题 内 容 
。 结 果 如 图 4-54 所 示 。 
通过 检查 实际 页 面 内 容 ， 可 以 知道 浏览 器 的 标题 并 不 是 “百度 一 下 ， 你 就 知道 ”"， 而 是 
“ Selenium IDE_ 百 度 搜索 ”。 那 么 为 什么 检查 点 提示 的 错误 信息 与 实际 内 容 不 一 致 呢 ? 为 了 
验证 最 后 结果 ， 继 续 执 行 完 最 后 一 步 检 查 点 验证 。 这 次 得 到 的 错误 日 志 如 图 4-55 所 示 。 


Bai 加 本 | seenum IDE 加 日 


网 页 。 新闻 。 周 吧 。 知 得 音乐 天 片 。 视 坑 地 图 文 吃 更 多 


ee 二 时 的 723 000 a 
加 SPMX 吉 看 ; 英文 结果 


Selenium IDE Plugins 


图 4-54 单 步 调试 页 面 图 4-55 Selenium IDE 单 步 调试 日 志 


可 以 发 现 这 次 检查 点 的 错误 信息 有 变化 ， 虽 然 还 是 错误 但 实际 结果 已 经 获取 正确 了 ， 只 
是 我 们 的 期 望 结果 没有 填写 准确 而 已 。 


而 与 正常 执行 测试 脚本 相 比 ， 添 加 “ 断 点 ”后 的 唯一 区 别 就 是 测试 被 短暂 地 暂停 过 。 由 
此 可 以 得 出 的 初步 结论 是 : 正常 执行 脚本 时 ， 检 查 点 获取 的 是 跳 转 前 页 面 的 标题 ;执行 脚本 
有 暂停 时 ， 检 查 点 获取 的 是 跳 转 后 页 面 的 标题 。 

由 初步 结论 ， 我 们 可 以 大 致 推断 出 可 能 的 原因 是 : 检查 点 命令 在 执行 时 不 会 特意 等 待 页 
面 跳 转 完成 ， 所 以 会 取 到 页 面 跳 转 前 的 标题 。 而 当 脚本 被 暂停 时 ， 页 面 在 此 期 间 已 经 跳 转 完 
成 ， 所 以 继续 执行 时 会 取 到 跳 转 后 的 标题 。 

为 了 解决 这 个 问题 ， 需 要 人 为 地 添加 一 个 暂停 的 效果 。 在 前 面 的 内 容 中 添加 的 是 一 个 
waitForElementPresent 命令 来 增加 一 个 动态 的 等 待 效果 。 


4.3.3 Selenium IDE 元 素 定位 


除了 Selenium IDE 基本 的 操作 之 外 ， 本 节 介 绍 Selenium IDE 对 元 素 定位 的 支持 。 在 使 
用 Selenium IDE 的 时 候 ， 如 何 定位 元 素 通常 都 不 是 一 个 问题 。 因 为 通过 录制 的 方式 Selenium 
IDE 都 会 帮助 自动 地 生成 元 素 定位 符 。 例 如 ， 单 击 百度 首页 输入 框 时 ， 它 会 自动 地 帮 我 们 生 
成 该 输入 框 的 定位 符 ， 如 图 4-56 所 示 。 

图 4-56 中 Selenium IDE 自动 生成 的 输入 框 定位 符 是 “id=kw”， 即 id 属性 为 kw 元素。 
除了 它 默认 生成 的 定位 符 之 外 ， 其 实 还 有 其 他 可 选 的 定位 符 。 具 体 可 以 通过 展开 Target 下 拉 
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框 来 查看 。 效 果 如 图 4-57 所 示 。 


Table [Souree| 


| |commad Target Value 


图 4-56 Selenium IDE 定位 符 | 4-57 Selenium IDE 定位 符 选择 
可 以 看 到 下 拉 框 中 除了 默认 的 定位 符 之 外 ， 还 有 其 他 可 选 定位 符 。 这 些 都 是 可 以 准确 
定位 到 百度 首页 输入 框 元 素 的 定位 符 。 而 之 所 以 Target 下 拉 框 中 的 默认 排序 如 此 ， 是 因为 在 
Selenium IDE 的 Options 中 有 设置 。 打 开 Options 对 话 框 可 以 看 到 排序 如 图 4-58 所 示 。 


General| Formats | Plugins WebDriver 


Drag and drop the locator builders on the left to change their order 


图 4-58 Selenium IDE 定位 符 构建 器 


可 能 会 发 现实 际 的 可 选 定位 符 比 Options 中 的 少 ， 那 是 因为 某 些 属性 该 元 素 不 具有 ， 所 
以 就 无 法 生成 对 应 的 定位 符 。 例 如 ， 只 有 A 元 素 才能 通过 link 生成 定位 符 。 
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除了 通过 录制 的 方式 来 自动 生成 定位 符 之 外 ， 还 可 以 手动 添加 或 修改 定位 符 元 素 。 例 
如 ， 把 单 击 百度 首页 一 输入 框 ， 修 改 为 单 击 百度 首页 一 “百度 一 下 ”按钮 。 其 具体 操作 如 下 。 

(1 ) 选择 “click” 命 令 所 在 行 ， 如 图 4-59 所 示 。 

(2 ) 单 击 Select 按钮 ， 如 图 4-60 所 示 。 


ET Table Souee 
Value Command Target Vak 
open /5 
id=kw 
Command click 司 Command dlick 一 
re fe 本 Ta -EEEEE 
Value Valu | 


图 4-59 Selenium IDE 脚本 命令 图 4-60 Selenium IDE 元 素 定位 
(3 ) 用 鼠标 在 页 面 上 选择 “百度 一 下 ”按钮 ， 如 图 4-61 所 示 。 


轩 路 CC | 时 mccope 女 | 自 如 全 9l-| 三 


5 haolz 2 四 5 Mi 3 术 32 we EE 


Ba 首开 


四 下 6 
FT 


图 4-61 浏览 器 页 面 元 素 高 亮 

(4) 查看 Target 内 容 ， 如 图 4-62 所 示 。 
通过 上 述 几 个 步骤 之 后 ， 可 以 看 到 click 的 对 象 已 经 由 原来 的 “id=kw” 和 替换 为 了 
“id=su”。 还 可 以 通过 Find 按钮 查看 该 元 素 在 页 面 的 ”fe 


实际 位 置 。 这 里 单 击 后 的 效果 如 图 4-63 所 示 。 ee 


提示 ”Selenium IDE 的 元 素 定 位 功能 非常 好 用 ， 
即使 不 使 用 Selenium IDE 作为 用 例 开发 的 主要 工具 ， | se 至 
也 可 以 单独 使 用 它 的 定位 功能 。 例 如 ， 生 成 那些 不 容 “|‖| 心 
易 定位 的 元 素 定位 符 。 


图 4-62 ”Selenium IDE 元 素 定 位 填充 
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加 ey x 
图 二 一 下 . 人 al 道 x 


(€) DR pnp baiducom 本 让 CE |] 窑 | 自 各 会 :| 三 


a 


08 证 
-@m@ 被 定位 的 元 素 背 景色 为 黄色 
Bai 人 WE 度 八 


三 正 


图 4-63 Selenium IDE 元 素 查看 


4.3.4 ”Selenium IDE 匹配 模式 


在 介绍 了 定位 功能 之 后 ， 本 节 要 讲 的 是 Selenium 的 匹配 模式 。 这 里 的 匹配 是 指 对 结果 
内 容 的 匹配 ， 针 对 的 是 所 有 的 验证 点 命令 ， 包 括 verify*、assert* 两 大 类 ， 例 如 verifyTitle、 


assertConfirmation 等 。 


在 Selenium IDE 中 使 用 匹配 模式 时 ， 其 统一 的 格式 为 : 匹配 前 缀 :匹配 关键 字 ， 如 图 
4-64 所 示 。 


Command verilyTile 


nv] ee] i 


Value 


图 4-64 Selenium IDE 匹配 


图 中 “ globp” 就 是 匹配 前 级 ， 而 “百度 一 下 ， 你 就 知道 !” 则 是 要 匹配 的 关键 字 内 容 。 
不 同 的 前 缀 代表 不 同 的 匹配 方式 。 在 Selenium IDE 中 匹配 模式 有 以 下 三 种 使 用 方式 。 

口 通 配 符 匹配 。 前 级 为 glob。 上 默认 的 匹配 方式 ， 前 级 可 以 省 略 。 

口 精 确 匹配 。 前 级 为 exact。 

口 正则 表达 式 匹 配 。 前 缀 为 regexp。 

接 下 来 ， 就 逐一 介绍 下 它们 各 自 的 使 用 方法 。 
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1. 通配符 匹配 

Selenium IDE 中 可 以 支持 的 通配符 只 有 三 个 ， 它 们 分 别 可 以 匹配 的 内 容 如 下 。 

口 * - 匹配 任何 数目 的 字符 。 

口 ? - 匹配 单个 字符 。 

口 [] - 特定 字符 类 ， 可 以 匹配 括号 内 发 现 的 任何 单个 字符 。 例 如 ，[0-9] 匹配 任何 数字 。 

这 里 假设 在 验证 百度 首页 标题 时 ， 只 需要 验证 标题 内 容 以 “百度 ”开头 即 可 。 使 用 通 配 
符 匹 配 模式 时 ， 其 内 容 如 图 4-65 所 示 。 

或 者 是 省 略 匹 配 前 级 的 形式 ， 如 图 4-66 所 示 。 


Base URL https://www.baidu.com, / = Base URL https://www.baidu.com/ 加 
一 > 中 >= le@ OO-e® PE Ie@ @-e 
Table | Source | Table | Source| 
Command Target Value | [command Target Value | | 
open / open 区 
站 veriyTitie glob 禁 度 " | MN ventTide 百度 * 
中 command RE a 由 I Che verilyTitle 
> msm || 二 pan Ce 
图 4-65 ”Selenium IDE 通配符 匹配 1 图 4-66 Selenium IDE 通配符 匹配 2 
2. 精确 匹配 
精确 匹配 模式 ， 是 指 检查 的 内 容 与 匹配 关键 字 要 完全 一 致 ， 即 通常 所 说 的 纯 文本 相等 匹 


配 。 该 匹配 模式 不 是 默认 的 匹配 模式 ， 如 果 要 使 用 精确 匹配 ， 需 要 添加 “ exact” 匹 配 前 级 。 
具体 的 使 用 效果 如 图 4-67 所 示 。 

在 精确 匹配 模式 下 ， 特 殊 符 号 都 会 被 当 作 普 通 字符 串 来 处 理 。 例 如 ，*.doc 仅 能 匹配 
“*.doc” 这 个 字符 串 ， 而 不 能 匹配 以 “.doc” 结 尾 的 字符 串 。 


3. 正则 表达 式 匹配 

正则 表达 式 匹配 模式 ， 顾 名 思 义 ， 就 是 可 以 支持 正则 匹配 规则 的 模式 。Selenium IDE 支 
持 完整 的 Java 语言 支持 的 regular 表达 模式 。Selenium IDE 中 正则 的 匹配 前 级 有 以 下 两 种 。 

口 regexp( 匹 配 时 区 分 字母 大 小 写 )。 

口 regexpi (匹配 时 不 区 分 字母 大 小 写 )。 

在 Selenium IDE 中 正则 表达 式 匹配 是 功能 最 强 的 匹配 方式 ， 它 是 通配符 匹配 与 精确 匹配 
的 超 集 。 任 何 可 以 通过 前 两 种 方式 匹配 的 内 容 都 可 以 使 用 正则 的 方式 来 匹配 。 使 用 正则 来 匹 
配 百 度 首页 标题 的 使 用 方式 如 图 4-68 所 示 。 
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Value 


Base URL https://www.baidu.com/ = Base URL https//wwwbaiducom/ | 
GC paps 二 |ee @-e@ Ga psps |oOe @-e@ 
Table [Source] Table [souree| 
;| | Command Target Value [enmend Target Value 
open 省 2 [ed / = 
verilyTitle exact 百 度 一 下 , 你 就 打道 S [verilyTitle regexp 漂 度 ” 加 
Command verifyTitle 司 Command VergTide 二 
| Ten er Ten | [ssa] [se 


Value 


[info] Test case passed 


Log | Reference | ULElement | Rollup Info” Clear 
[info] Playing test case Untitled 2 四 | 
[info] Executing: lopen | / 11 | 
[info] Executing: |verifyTitie | exact: 百 度 一 下 ,你 就 0 道 | | 国 


Log | Reference | Ul-Element | Rollup | 
Tinfo] Playing test case Untitled 2 
[info] Executing: lopen | /11 

[info] Executing: |verifyTitle | regexp: 百 度 .= | | 国 


Info- 让 


图 4-67 Selenium IDE 精确 匹配 


4.3.5 ”Selenium IDE 脚本 转换 


[info] Test case passed 


图 4-68 Selenium IDE 正则 匹配 


通过 Selenium IDE 录制 的 脚本 可 以 直接 在 IDE 中 回放 ,但 是 如 果 想 在 其 他 机 器 上 被 回 


放 ， 则 需要 相应 的 Firefox 和 Selenium IDE 环境 。 为 了 使 录制 的 脚本 能 够 方便 地 移植 到 其 他 
机 器 或 平台 上 来 执行 ，Selenium IDE 很 友好 地 提供 脚本 转换 的 功能 。 即 可 以 通过 Selenium 


IDE 把 录制 的 脚本 转换 成 特定 的 语言 脚本 ， 例 如 Python 脚本 。 
在 介绍 脚本 转换 之 前 ， 先 来 了 解 下 Selenium IDE 默认 录制 的 脚本 是 以 什么 形式 存在 的 ， 


具体 通过 Selenium IDE 界面 ， 并 单 击 Source 标签 来 查看 ， 如 图 4-69 所 示 。 


Untitled 2 (untitled suite) - Selenium IDE 291 
CH 


文件， 闹 得 日 Actions Options 帮助 


Base UR htps//wwwbeiducomy 


neta http-equiv=“Content-Type” content="text/htal; charset=UTP-8" /> 
link rel="seleniun. base” href="https://mrw. baidu com/” /> 
Ctitle er TestC/ title> 


《table cellpadding="1” cellspacing="1” border="1"> 


<thead> 
Ctr Ytd rowspan="1” colspan="3" Ne Test /td>C/tr> 
thead> tbody> 
《tr> 

tdYopend/ td> 

DS 

《ata> 


CdrverifyTitle td> 
<td)regexp :百度 .*<ftd> 
Ytd> 


tbody> Ytable> 
‘ 


图 4-69 Selenium IDE 源码 模式 
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从 图 4-69 中 可 以 看 出 ，Selenium IDE 录制 的 脚本 默认 是 以 HTML 的 形式 存放 的 。 具 体 


的 步骤 是 保存 在 table 元 素 中 ， 其 中 每 一 行 代表 用 户 的 一 个 操作 或 场景 。 而 转换 为 


他 语言 


脚本 的 时 候 就 是 基于 此 文件 ， 通 过 设置 Selenium IDE 的 Format 可 以 改变 Source 中 的 脚本 格 


式 。 具 体操 作 如 下 。 
(1 ) 单 击 菜单 栏 中 的 Options 菜单 。 
(2 ) 选择 Format 子 菜单 ， 如 图 4-70 所 示 。 


Reset DE window 
Clear history » 
Schedule tecte to run Periodicaly 


eageadtdy 
RD Yi 
rr 


bverityTite dtd 
tregexp: 百 度 -#1t4》 
DID 


Ey 
C0/ NUrit/ WebDriver 

Cs /NUnit/ Remote Contral 

Jowa /JUnit 4 / WebDriver 

Java/ TecthG / WebDriver 

Jova/ JUnit 4/ WebDriver Badked 
Java /JUnit 4/ Remore Control 
Java / JUnit 3 / Remote Comtrol 
Java/ TectNG /Remats central 
python 2/ unitest / WebDrver 
Pyrhon 2/ unimest / Remote Control 
Ruby 1 RSpec / WebDriver 

Ruby / TecteUnit / WebDriver 

Ruby / RSpec / Remote Control 


4-70 Selenium IDE 转换 脚本 选择 
(3 ) 在 二 级 子 菜单 中 选择 一 个 具体 的 Format， 这 里 选择 Python 2/unittest/WebDriver。 


(4 ) 查看 Source 中 的 脚本 代码 ， 如 图 4-71 所 示 。 


F 一 一 一 一 一 一 一 一 一 一 
@ Untitled 2 (untitled suite) - Selenium IDE 2.9.1* 
一 一 -人 


文件 号 往 (日 Actions Qptions 帮助 
Base URL https//wwwbaiducom/ 

C7 on 
[| source 


Erom seleniun. webdriver. support. ui import Select 


import unittest, tine, re 


class Untitled2 (unittest. TestCase) 
def setUp (self) 
self driver = webdriver Pirefox 0 
self driver. inplicitly_wait (30) 
self base_ur] = “https’//mre baidu con/” 
self. verificationErrors = [] 
self. accept_next_alert = True 


test_untitled2 (self) 
driver = self driver 


driver get (self base_url + “/") 


Erom seleniun. common. exceptions inport NoSuchElenentException 
Erom seleniun. common exceptions inport NoAlertPresentException 


try: self. assertRegexpllatches (driver. title, r“ 百 度 .*") 
except AssertionBrror as se; self. verificationErrors sppend(str (e)) 


is_elenent_present (self£, hox, what) 
try: self. driver. find_elenent (by=how, value=what) 
except NoSuchElenentException as e: return False 


图 4-71 Selenium IDE 转换 脚本 


通过 上 述 步骤 的 操作 ， 可 以 看 到 Source 中 的 脚本 已 经 变 成 了 Python 语言 的 脚本 ; 同样 
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的 操作 还 可 以 转换 成 其 他 支持 的 语言 脚本 。 这 里 可 以 把 转换 后 的 脚本 复制 并 保存 到 一 个 独立 
Python 文件 中 ， 例 如 demo_test.py。 然 后 执行 该 Python 脚本 。 
Python demo test.py 


如 果 已 经 按照 前 面 的 章节 搭建 好 了 测试 环境 ,那么 这 里 将 可 以 正常 地 执行 该 测试 脚本 ， 
并 且 效 果 与 Selenium IDE 中 执行 的 是 一 样 。 


除了 上 面 的 脚本 转换 方法 ， 还 可 以 通过 Selenium IDE 的 导出 功能 来 转换 测试 脚本 。 这 征 


以 导出 为 Python 脚本 为 例 ， 具 体 步 又 如 下 。 
(1) 单 击 Selenium IDE 的 File 菜单 。 
(2 ) 选择 Export Test Case As…。 
(3 ) 单 击 Python 2 / unittest / WebDriver， 如 图 4-72 所 示 。 


@ 
1 Eee 


C4/ NUnit/ WebDriver 

cy/ NUnit/ Remote Contrel 

Jave /JUrit 4 / WebDriver 

Java / TestNG / WebDriver 

Java 1 JUrit 4/ WebDriver Backed 


Ruby / TestsUrit / WebDriver 
Raby /RSpec / Remote Cortrol 
| Ruby /TestUrit / Remcte Control 


图 4-72 Selenium IDE 导出 脚本 


(4 ) 选择 保存 路 径 并 填写 “demo_testpy” 作 为 文件 名 保存 。 


注意 Selenium IDE 1.0.11 之 后 的 版 本 formatters 功能 默认 是 关闭 的 ， 原 
个 版 本 没有 向 前 兼容 并 且 有 部 分 问题 没有 解决 ， 所 以 官方 推荐 的 脚本 转换 方式 是 通过 上 述 
步骤 来 导出 到 文件 。 另 外 ，Selenium IDE 同时 只 能 导出 一 个 用 例 ， 导 出 的 为 当前 正在 编辑 


的 用 例 。 


最 后 ,通过 编辑 器 查看 下 导出 的 Python 脚本 文件 内 容 ， 其 具体 代码 如 下 。 


= oodings utf-8 一 “一 
from selenium import webdriver 


虽 


是 该 功能 这 
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from selenium.webdriver.common.by import By 

from selenium.webdriver.common.keys import Keys 

from selenium.webdriver.support.ui import Select 

from selenium.common.exceptions import NoSuchElementException 
from selenium.common.exceptions import NoAlertPresentException 
import unittest, time, re 


class demo(unittest.TestCase): 
def setUp (self) : 
self.driver = webdriver.Firefox() 
self.driver.implicitly wait (30) 
self.base url = "http://www.baidu.com/" 
self.verificationErrors = [] 
self.accept next alert = True 


def test demo (self): 
driver = self.driver 
driver.get (self.base url + "/") 
driver .find element_by_id("kw") .click() 
driver .find element_by_id("kw") .clear() 
driver .find element by id("kw") .send keys ("Selenium") 
driver .find element_by_id("su") .click() 
self.assertEqual (u"selenium_ 百度 搜索 "，driver.title) 


def is element present(self, how, what): 
try: self.driver.find element (by=how, value=what) 
except NoSuchElementException as e: return False 
return True 


def is alert present (self): 
try: self.driver.switch to alert() 
except NoAlertPresentException as e: return False 
return True 


def close alert and get_its text (self): 
try: 
alert = self.driver.switch to alert() 
alert text = alert.text 
if self.accept next alert: 
alert.accept () 
else: 
alert.dismiss() 
return alert text 
finally: self.accept next alert = True 


def tearDown (self): 
self.driver.quit () 
self.assertEqual ([], self.verificationErrors) 


if name ==" main ": 


unittest.main() 


上 述 代码 是 基于 3.3.1 节 中 录制 的 脚本 而 导出 的 。 从 代码 中 可 以 看 出 ， 这 是 一 个 标准 的 
单元 测试 格式 ， 具 体 使 用 的 则 是 Python 的 unittest 模块 。 除 了 典型 的 setUp 和 tearDown 方法 
之 外 ， 其 主要 的 测试 方法 就 是 test_demo。 该 方法 中 的 代码 内 容 就 是 录制 测试 场景 时 的 具体 操 
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此 外 ， 在 导出 的 测试 脚本 中 ， 部 分 特定 的 内 容 是 可 以 修改 的 。 例 如 ， 测 试 文件 的 


Formats 选项 中 设置 。 具 体 打开 设置 框 的 步骤 如 下 。 
(1 ) 单 击 Options 菜单 的 Options… 子 菜单 ， 如 图 4-73 所 示 。 


(2 ) 选择 Formats 选项 卡 ， 在 左 侧 单 击 要 设置 的 语言 项 ， 如 Python 2/unittest/WebDriver， 


如 图 4-74 所 示 。 


人 Tea ii mm 页 


Schedule tests to run periodically 


图 4-73 ”Selenium IDE 选项 


件 头 尾 模板 、 采 用 的 缩 进 方式 等 。 


| 


Selenium IDE Options > mn 4 人 


sare rome 


Plugins [Locator Builders [ WebDriver | 


Python 2 / unittest / WebDriver 


HTML 
C#/ NUnit /~ | Variable for Selenium instance 
C#/ NUnit/ .| -一 
| driver 
Java / JUnit 4 .. 
Selenium RC host 
Java / TestNG... 
Java /JUnit4 -| localhost 
Jave / JUnit 4 Selenium RC port 
Java /JUnit 3 
Jave / TestNG., Environ 
hr 
Python 2 / un... 
Ruby / RSpec... - 
Ruby / Test-U.. fr 白 
Ruby / RSpec..| from sejeniumwebdrivercommonbyimport By 
from selenium.webdriver.commonikeys import Keys 
Ruby / Test=U... 


from selenium.webdriver.supportui import Select 


Footer 


def is_element_present(self, how what): 国 
tnr self.driver.find_element(by=how, value=what) 
except NoSuchElementException as e: return False 


return True 而 
Indent 
[4 spaces 加 
FE 


图 4-74 Selenium IDE 格式 化 设置 


〈3 ) 在 右 侧 设置 相关 内 容 。 如 Selenium 的 实例 变量 名 、RC 的 HOST 和 端口 、 脚 本 的 文 


通过 上 述 设置 之 后 ， 再 次 转换 代码 时 就 会 使 用 配置 的 内 容 来 生成 测试 脚本 。 


包 名 
称 、 测 试 驱动 的 变量 名 、 远 程 Server 的 链接 地 址 与 端口 等 。 要 设置 这 些 具 体 的 内 容 ， 可 以 在 


CHAPTER 


第 5 章 
p Selenium 常规 对 象 接口 


Selenium IDE 固然 好 用 ， 但 它 仅 适 合 那些 Selenium 的 新 手 来 使 用 和 学 习 如 何 开 发 测试 肢 
本 。 对 于 大 规模 的 自动 化 项 目 实施 ， 使 用 IDE 就 会 有 点 儿 束 手 束 脚 ， 不 方便 代码 的 优化 和 封 
装 ， 这 时 就 需要 自主 开发 测试 脚本 。 

本 章 主要 介绍 Selenium 对 象 的 常用 接口 ， 帮 助 读 者 快速 地 熟悉 和 掌握 如 何 使 用 
Selenium 的 相关 对 象 ， 及 如 何 封装 一 些 常用 的 操作 方法 。 


5.1 浏览 器 对 象 操作 


5.1.1 ”查找 元 素 方 法 

浏览 器 对 象 中 最 常 使 用 的 方法 就 是 查找 元 素 的 方法 ， 也 就 是 前 面 几 章 提 到 过 很 多 次 的 
find_element_by_XXX 类 方法 。 通 常 在 使 用 这 类 方法 之 前 需要 提前 实例 化 好 对 应 的 浏览 器 对 
象 ， 然 后 可 以 直接 调用 浏览 器 对 象 的 查找 元 素 方法 。 具 体 使 用 步骤 如 下 所 示 。 


#!/usr/bin/env Python 
天 eoding: vtf-8 ~#= 
from selenium import webdriver 


wd = webdriver.Firefox() 
wd.get ('http://www.baidu.com') 


wd.find element by id('kw').send keys('selenium') 
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wd.find element by css('#su').click() 
wd.find element by linktext(u' 下 一 页 ') 


wd.close () 


当然 除了 代码 中 使 用 的 查找 元 素 方法 外 ， 更 多 的 查找 元 素 方法 和 使 用 技巧 见 第 3 章 。 


5.1.2 ”浏览 器 窗口 方法 

Selenium 中 提供 了 直接 在 代码 中 操作 浏览 器 窗口 的 方法 ， 通 过 这 些 方法 可 以 根据 实际 的 
测试 需要 对 浏览 器 本 身 进 行 操作 ， 例 如 ， 访 问 URL、 调 整 浏览 器 大 小 、 前 进 /后 退 等 。 这 里 
介绍 下 最 常用 的 方法 ， 更 多 方法 的 支持 和 使 用 可 以 通过 dir0 来 查询 具体 详情 ,或 者 也 可 以 去 
线 上 社区 进行 提问 。 具 体 的 使 用 示例 如 下 所 示 。 

#!/usr/bin/env Python 

一 Oh 


from selenium import webdriver 


wd = webdriver.Firefox() 


wd.get ('http://www.baidu.com') // 访 问 url 
wd.maximize_window () // 最 大 化 浏览 器 
print wd.current url, wd.title, wd.name // 浏览 器 当前 的 url、title、name 


wd.find element by id('kw').send keys('selenium') 
wd.find element by css_selector('#su').click() 


wd.set window size(800, 600) ## 设置 浏览 器 的 宽 ， 高 

print wd.get window_ size() ## 获取 浏览 器 窗口 的 宽 、 高 

wd.set window position(100,200) ## 设置 浏览 器 的 左上 坐标 x，y 值 
print wd.get window position() ## 获取 浏览 器 的 左上 坐标 位 置 
wd.back () // 后 退 

wd.forward() // 前 进 

wd.close() // 关闭 浏览 器 ， 或 wd.quit () 


5.1.3 ”Cookie 处 理 方法 


对 于 一 般 的 测试 场景 而 言 ， 前 面 两 节 提 到 的 方法 已 经 可 以 满足 测试 需求 。 然 而 对 于 某 
些 特 殊 架 构 设计 的 系统 而 言 ， 可 能 还 需要 更 多 的 浏览 器 支持 方法 。 这 就 是 本 节 所 要 讲 的 对 于 
Cookie 的 管理 和 操作 。 

Cookie 是 浏览 器 用 来 存储 服务 器 传递 过 来 的 需要 进行 保存 的 用 户 信息 ， 浏 览 器 在 下 次 请 
求 服务 器 的 时 候 会 把 有 效 的 Cookie 信息 带 上 ， 用 于 服务 器 识别 当前 浏览 器 的 身份 。Selenium 
中 也 提供 了 对 于 Cookie 管理 的 所 有 方法 ， 包 括 添加 、 获 取 、 删 除 。 具 体 代码 示例 如 下 所 示 。 


#!/usr/bin/env Python 
odiny: tf-0 一 二 
from selenium import webdriver 
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wd = webdriver.Firefox() 
wd.get ('http://www.baidu.com') 
print wd.get cookies() 


## 访问 url 
## 获取 所 有 cookie 


wd.add cookie({'name':'kw', 'value':'selenium'}) 


print wd.get cookie('kw') 
Print wd.get cookies() 
wd.delete cookie('kw') 
print wd.get cookies() 
wd.delete all cookies() 
print wd.get cookies() 
wd.close () 


## 添加 一 个 name 为 kw 内 容 为 selenium 的 cookie 
## 获取 name 为 kw 的 cookie 


## 删除 name 为 kw 的 cookie 


## 删除 所 有 cookie 


## 关闭 浏览 器 


注意 ”对 于 Cookie 的 操作 中 并 没有 直接 提供 更 新 的 方法 ， 如 果 需 要 对 Cookie 的 值 进行 


更 新 操作 ， 那 么 可 以 先进 行 Cookie 的 删除 操作 ， 再 进行 Cookie 的 添加 操作 即 可 。 


5.2 WebElement 对 象 操作 


WebElement 对 象 在 Selenium 中 是 所 有 元 素 对 象 的 父 类 ， 也 就 是 说 ，WebElement 对 象 所 
拥有 的 方法 ， 其 他 元 素 对 象 都 会 有 ， 只 是 不 同 的 对 象 在 调用 特定 方法 时 其 效果 是 不 一 样 的 。 
简 而 言 之 ， 就 是 某 些 方法 只 是 针对 特定 元 素 类 型 有 效 ， 而 对 其 他 元 素 类 型 无 效 。 下 面 将 列 出 
WebElement 对 象 所 支持 的 方法 和 属性 ， 具 体 子 项 罗列 如 下 。 

D clear : 清空 文本 框 中 的 文本 ， 仅 对 有 文本 输入 特性 的 元 素 有 效 ， 例 如 文本 框 、 多 行文 


本 框 等 。 


D click: 单 击 元 素 ， 可 以 通过 该 方法 让 元 素 获取 焦点 。 

口 find_element 系列 : 查找 子 元 素 的 方法 ， 同 浏览 器 对 象 的 find_element 系列 方法 相同 。 
口 get_attribute: 获取 当前 元 素 的 特定 属性 值 ， 如 name、style 等 。 

口 id: 表示 当前 元 素 在 Selenium 中 的 唯一 标识 符 。 

Dis_displayed: 当前 元 素 是 否 可 见 ， 例 如 ，display:none 样式 即 为 不 可 见 。 

口 is_enabled: 当前 元 素 是 否 可 用 ， 例 如 ， 设 置 disabled 属性 后 为 不 可 用 。 

Dis_selected : 当前 元 素 是 否 被 选中 ， 通 常用 在 checkbox 、radiobox 、select option 等 元 


素 上 。 


口 location: 返回 当前 元 素 的 左上 和 角 坐 标 x、y 的 位 置 ， 即 在 当前 页 面 中 的 绝对 位 置 坐标 。 


口 location_ once _scrolled into view : 返回 当前 元 素 第 一 次 滚动 到 可 视 区 域 时 的 左上 和 角 坐 


标 x、y 的 位 置 ， 使 用 此 方法 可 以 把 不 在 可 视 区 域 的 元 素 滚动 到 可 视 区 域 。 


口 parent: 返回 WebDriver 对 象 。 
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口 rect: 返回 当前 元 素 左上 角 坐 标 x、y 值 ， 以 及 该 元 素 的 宽 和 高 ， 即 该 元 素 的 显示 区 域 。 
口 send_keys : 向 当前 元 素 发 送 字符 串 内 容 ， 仅 对 可 输入 Web 元 素 有 效 ， 如 文本 框 、 文 


本 区 域 等 。 


口 size: 获取 当前 元 素 的 宽 和 高 。 


口 submit : 提交 当前 元 素 所 在 的 FORM 表单 ， 相 当 于 单 击 所 在 FORM 表单 内 的 Submit 


按钮 。 


口 tag_name: 获取 当前 元 素 的 tag name 内 容 ， 如 文本 框 的 值 为 input。 

口 text: 获取 当前 元 素 的 innerText 值 ， 即 元 素 开始 标签 和 结束 标签 之 间 的 文本 内 容 。 

口 value_of css_property: 获取 当前 元 素 的 CSS 属性 ， 如 获取 color 属性 值 。 

为 了 更 好 地 理解 每 一 个 方法 和 属性 的 作用 ， 这 里 就 对 照 一 个 具体 的 DIV 元 素来 进行 学 


习 。 假设 DIV 元 素 的 HTML 源码 如 下 。 


<div class="demo_css" id="demo" 
height:100px; color:#FF0000; display:inline-block; 


name="selenium" style="width:300px; 


"><p>Selenium Book</p></div> 


当 通 过 Selenium 脚本 对 DIV 对 象 进行 各 项 操作 时 ， 其 代码 和 对 应 的 效果 如 下 所 示 。 


#!/usr/bin/env Python 
# -*- coding: utf-8 -*- 


from selenium import webdriver 


wd = webdriver.Firefox() 
wd.get ('you url') 


div = wd.find element by _ idl('demo') 


div.clear() ### ==> 无 效果 

div.click() ## ==> 无 效果 

p = div.find element by tag name('p') ## ==> 返回 P 对 象 

print div.get attribute('name') ## ==> selenium 

print div.id ## ==> u'{357c3721-038e-4072-9ea9-bd50caa2a252}' 

print div.is displayed() ## ==> True 

print div.is enabled() ## ==> True 

print div.is_selected () ## ==> False 

print div.location ## me ys la0s Ls L12909 

print div.location once scrolled into view ## ==> {'y': 18.0, 'x': 129.0} 

div.parent ## ==> WebDriver 对 象 

p.parent ## ==> WebDriver 对 象 

print div.rect ## ==> {u'y': : 129, u'height': 100, u'width': 300} 

div.send keys('hello world') ## ==> 

print div.size ## 一 > {'width': 300, 'height': 100} 

div. submit () ## ==> 提交 所 在 的 FORM 表单 ， 不 在 表单 
中 则 无 效果 

print div.tag name ## ==> div 

print div.text ## ==> Selenium Book 
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print value of css_property('color') ## ==> #FF0000 


wd.close() 


上 面 的 效果 只 针对 DIV 元 素 ， 并且 还 有 部 分 方法 和 属性 并 未 生效 。 接 下 来 将 对 有 特殊 效 
果 的 Web 元 素 对 象 进行 功能 介绍 。 


5.3 ”文本 框 对 象 操作 


在 Selenium 中 文本 框 对 象 指 的 是 HITML 中 type 值 为 text 的 input 节 点 ， 如 下 面 的 
HTML 代码 所 示 。 

<input type="text" class="s ipt" name="wd" id="kw" maxlength="100" /> 

文本 框 对 象 是 我 们 在 操作 网 页 时 最 常用 到 的 对 象 之 一 ， 对 于 文本 框 对 象 通常 的 操作 就 是 
输入 值 、 获 取 值 、 设 置 其 属性 、 获 取 其 属性 等 。 下 面 的 代码 将 列 出 文本 框 对 象 通常 会 使 用 到 
的 方法 和 属性 ， 如 以 下 代码 所 示 。 


#!/usr/bin/env Python 
# -*- coding: utf-8 -*- 
from selenium import webdriver 


wd = webdriver.Firefox() 
wd.get ('you url') 
kw = wd.find element by_id('kw') 


kw.send_keys ('selenium') ## ==> 向 文本 框 输入 "selenium" 
kw.clear() ## ==> 清空 文本 框 内 容 

kw.send_keys ('selenium book') ## ==> 向 文本 框 输入 "selenium book" 
print kw.get attribute('value') ## ==> 返回 "selenium book" 
wd.close () 


上 面 代 码 中 主要 涉及 对 文本 框 内 容 的 填写 、 清 空 和 获取 操作 ， 也 是 文本 框 的 常规 操作 ; 
获取 文本 框 其 他 属性 的 方法 与 5.2 节 中 用 法 一 致 。 


S.4 ”按钮 对 象 操作 


按钮 对 象 也 是 经 常 需 要 操作 的 对 象 之 一 ， 主 要 指 的 是 type 属性 为 button 的 input 元 素 
或 者 button 元 素 ; 这 里 以 input 元 素 作为 示例 讲解 ， 假 设 其 HTML 代码 如 下 。 

<input type="button" class="s_ipt" value=" 测试 " id="su"/> 

对 于 按钮 对 象 常用 的 操作 就 是 单 击 和 获取 显示 的 内 容 ， 对 应 的 Selenium 中 代码 的 脚本 如 
以 下 代码 所 示 。 
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#!/usr/bin/env Python 
非 ~-*= Coding: utf=8 -*-— 
from selenium import webdriver 


wd = webdriver.Firefox() 
wd.get('you url') 
su = wd.find element by id('su') 


su.click() ## ==> 单 击 按钮 
print kw.get attribute('value') ## ==> 返回 "测试 " 
wd.close () 


5.5 下 拉 列 表 对 象 操作 


下 拉 列 表 对 象 即 为 select 元 素 对 象 ， 该 元 素 下 面 需要 有 option 子 元 素 才 可 以 显示 下 拉 菜 
单 的 内 容 。 通 常 我 们 定位 时 直接 定位 到 select 元 素 ， 而 具体 操作 时 还 需要 涉及 option 元 素 ， 
因此 在 操作 上 需要 一 些 注意 的 地 方 。 这 里 以 下 面 的 select 元 素 的 HTML 代码 为 例 来 学 习 如 何 
操作 select 对 象 。 


<select id="lang" name="lang"> 
<option value ="python" selected>PYTHON</option> 
<option value ="java">JAVA</option> 
<option value="ruby">RUBY</option> 
<option value="php">PHP</option> 
</select> 


接 下 来 的 代码 里 将 依次 对 select 对 象 进 行 子 项 选择 、 获 取 选 中 内 容 的 操作 ， 具 体 见 如 下 
代码 。 


#!/usr/bin/env Python 
天 = codings ‘utr ="= 
from selenium import webdriver 


wd = webdriver.Firefox() 

wd.get ('you url') 

select = wd.find element by id('lang') 

options= select.find elements_by_tag_name('option')  ## ==> 获取 所 有 的 option 子 元 素 
options[2] .click() ## ==> 选择 第 3 个 option 子 项 


for i in range (Jen (options) ) : 


if options[i].get attribute('value') == "Python' : 
options [i] .click() ## ==> 选择 value 值 为 python 的 子 项 
break 


for i in range(len (options)): 
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if options[i].text == 'PYTHON': 
options [i] .click() ### ==> 选择 text 值 为 PYTHON 的 子 项 
break 


for i in range (len(options)) : 
if options[i] .get_attribute('selected') : 


print options [i] .get_attribute('text') ## ==> 返回 当前 被 选中 子 项 的 
text 内 容 

print options [i] .get_attribute('value') ## ==> 返回 当前 被 选中 子 项 的 
value 内 容 

break 


wd.close () 


从 上 面 的 代码 可 以 看 到 ， 操 作 select 对 象 可 以 有 三 种 可 选 方法 ， 分 别 是 通过 索引 、value 
和 text 属性 。 除 了 可 以 使 用 上 面 的 代码 以 外 ，Selenium 也 提供 了 select 对 象 的 操作 库 ， 同 档 
的 功能 ， 使 用 Select 库 的 代码 如 下 所 示 。 


#!/usr/bin/env Python 

一 

from selenium import webdriver 

from selenium.webdriver.support.select import Select 


tk 


wd = webdriver.Firefox() 
wd.get ('you url') 


select = Select (wd.find element by _id("lang"))  ## 获取 Select 对 象 


options= select.options () ## ==> 获取 所 有 的 option 子 元 素 
select.select by index(2) ## ==> 选择 第 3 个 option 子 项 
select.select by value('python') ## ==> 选择 value 值 为 python 的 子 项 
select.select by visible text('PYTHON') ## ==> 选择 text 值 为 PYTHON 的 子 项 


option = select.first_selected option() ## ==> 返回 第 一 个 或 者 当前 被 选中 子 项 
print option.get_attribute('value') ## ==> 获取 子 项 的 value 值 


wd.close () 


5.6 ”链接 对 象 操作 


最 后 介绍 下 链接 对 象 ， 对 于 链接 对 象 常见 的 操作 为 单 击 、 获 取 链 接 文字 以 及 链接 地 址 
等 。 这 里 假设 链接 的 HTML 内 容 如 下 。 


<a href="http://www.seleniumhq.org" id="selenium">Selenium 官网 </a> 
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对 于 该 链接 元 素 可 以 进行 的 操作 及 对 应 的 效果 见 如 下 代码 。 
#!/usr/bin/env Python 
dings Wi 


from selenium import webdriver 


wd = webdriver.Firefox() 
wd.get ('you url') 


a = wd.find element_by_id("selenium") 


eb ## ==> 单 击 链接 

print a.text ## ==> 返回 "Selenium 官网 " 

print a.get attribute('href') ## ==> 返回 "http://www.seleniumhq.org" 
wd.close () 


到 此 为 止 ， 日 常 所 需要 操作 的 基本 元 素 都 已 介绍 过 ， 大 部 分 的 元 素 操作 效果 都 是 一 样 
的 ， 只 有 少数 的 几 个 方法 是 针对 特定 元 素 类 型 的 ， 针 对 不 同 元 素 使 用 正确 的 方法 即 可 。 接 下 
来 将 介绍 一 些 特殊 场景 里 会 遇 到 的 对 象 及 其 处 理 方法 。 


CHAPTER 


06 Web UI 自动 化 特殊 场景 处 理 


第 5 章 中 学 习 了 常见 Web 元 素 的 操作 ， 本 章 学 习 如 何 处 理 测 试 过 程 中 的 一 些 特殊 的 场 
景 。 这 些 场景 会 时 不 时 地 出 现在 测试 执行 过 程 之 中 ， 只 有 处 理 好 这 些 场景 才能 让 测试 过 程 正 
常 进行 。 接 下 来 一 一 介绍 。 


6.1 处理 多 窗口 测试 场景 


这 里 的 多 窗口 指 的 是 多 个 浏览 器 窗口 ， 并 且 是 从 同一 个 浏览 器 进程 中 打开 的 多 个 窗口 ; 
例如 ， 通 过 单 击 链接 而 打开 的 新 窗口 或 者 选项 卡 ; 对 于 这 类 场景 ， 我 们 在 进行 元 素 查 找 和 操 
作 的 时 候 ， 需 要 切换 WebDriver 到 对 应 的 浏览 器 对 象 上 ， 才 能 保证 后 续 的 元 素 操 作 有 正确 的 
结果 。 其 逻辑 的 大 致 示意 如 图 6-1 所 示 。 

即 如 果 我 们 需要 单 击 “ 百 度 一 下 ”时 ， 必 须 先 把 WebDriver 对 象 与 浏览 器 1 进行 一 
个 绑 定 ， 而 当 我 们 需要 查找 Selenium 官网 中 的 Download Selenium 链接 时 ， 就 需要 先 把 
WebDriver 对 象 与 浏览 器 2 进行 绑 定 ， 然 后 才能 进行 正确 的 元 素 查 找 操作 ， 否 则 将 会 报 元 素 
未 找到 错误 。 

既然 处 理 多 浏览 器 场景 的 关键 是 浏览 器 间 的 切换 ， 那 么 接 下 来 就 看 看 具体 操作 的 代码 ， 
详 见 如 下 代码 。 

#!/usr/bin/env python 


娄 codings ntf=B = 
from selenium import webdriver 
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wd = webdriver.Firefox() 

wd.get ('http://www.baidu.com') 

wd.find element by _ id('kw').send keys('selenium') 

wd.find element by id('"su').click() 

first link = wd.find element by css_selector('#content left a:nth-child(1)') 


first_ link.click() ## ==> 单 击 第 一 个 结果 的 链接 ， 此 时 会 弹出 新 窗口 或 选项 卡 

whds = wd.window handles ## ==> 获取 所 有 浏览 器 对 象 的 句柄 ， 此 时 为 两 个 句柄 

print whds ## ==> [u'{146a3f33-24fe-4ba6-89ac-7b7007a427ef}', 
u'{9clafe61-e73a-4ael-ac08-d53670aa0611}'] ,其 中 第 一 个 为 ' 百 


度 '， 窗口 句柄 ， 第 二 个 为 新 开 窗 口 的 句柄 


wd.switch to window (whds [1]) ## ==> 切换 WebDriver 到 新 窗口 
print wd.title ## ==> 新 窗口 的 title: 'Selenium - Web Browser Automation' 


wd.switch to_window (whds[0]) ## ==> 切换 WebDriver 到 原 窗口 
原 窗口 的 title: 'selenium 百度 搜索 


print wd.title 


wd.close () 


WebDriver 


Which part of Selenium is appropriate for me? 


Sewnium OE 


二 是 划 约 仙 工 上 的 一 因 直 叶 站 学 习 坟 大 和 
PO TT TT ST FY A ] 


村 江 灶 有 slanurm 技 行 自动化 读 个 人 避 疆 ) 百 记录 只 
013F7R24G 作为 个 家 名和 之 和 


图 6-1 多 窗口 场景 
从 代码 中 可 以 看 到 ， 切 换 WebDriver 与 浏览 器 之 间 绑 定 的 方法 为 switch_ to_ window， 该 


方法 接收 一 个 name 或 者 句柄 作为 参数 ， 然 后 将 WebDriver 对 象 与 之 绑 定 ， 接 着 就 可 以 查询 
和 操作 被 绑 定 的 浏览 器 中 的 元 素 。 
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注意 switch to_window 方法 接收 的 参数 中 ，name 为 浏览 器 窗口 的 name 属性 ， 并 非 浏 
览 器 的 title 值 ， 也 并 非 WebDriver 对 象 的 name 属性 ， 该 属性 可 以 通过 Windows Spy 之 类 的 
工具 进行 查找 ; 另 一 个 参数 为 window_handle， 即 浏览 器 窗口 的 句柄 ， 从 代码 里 可 以 看 到 直 
接 使 用 window_handles 属性 即 可 获取 到 。 


6.2 ”处 理 浏览 器 弹 框 场景 


在 日 常 的 测试 场景 中 ， 经 常会 遇 到 浏览 器 的 弹 杠 提示， 虽然 这 种 提醒 用 户 的 方式 不 是 很 
优雅 ， 并 且 大 多 数 专业 的 前 端 开发 人 员 早 已 不 再 这 样 使 用 了 ， 但 是 在 自动 化 的 场景 中 如 果 遇 
到 了 ， 还 是 需要 去 解决 和 处 理 的 。 

由 于 浏览 器 的 弹 框 不 属于 HTML 页 面 元 素 ， 而 是 属于 Windows 的 控件 元 素 ， 所 以 
Selenium 在 处 理 弹 框 时 的 方式 与 处 理 HTML 元 素 时 是 不 一 样 的 。 不 能 通过 浏览 器 的 类 find 
方法 来 查找 弹 框 ， 而 是 使 用 与 处 理 多 浏览 器 一 样 的 方式 ， 即 使 用 类 switch 的 方式 来 获取 弹 
框 。 接 下 来 就 看 看 在 Selenium 中 处 理 Alert 的 方式 。 


6.2.1 Alert 对 象 及 方法 
想 要 获取 Alert 对 象 ， 有 如 下 几 种 方式 。 


#!/usr/bin/env Python 

# -*- coding: utf-8 -*- 

from selenium import webdriver 

from selenium.webdriver.common.alert import Alert 
from time import sleep 


wd = webdriver.Chrome () 
wd.get (r'file:///C:/Users/Administrator/Desktop/alert.html') 


wd.find_element by id('alert') .click()  ## ==> 单 击 触发 弹 框 的 元 素 

alt = wd.switch to alert() ## ==> 第 一 种 方式 ， 后 期 会 被 抛弃 不 再 支持 
sleep (1) 

alt.accept () 

wd.find element by id('alert').click()  ## ==> 单 击 触发 弹 框 的 元 素 

alt = wd.switch to.alert ## ==> 第 二 种 方式 

sleep (1) 

alt.accept () 

wd.find element by id('alert').click()  ### ==> 单 击 触发 弹 框 的 元 素 

alt = Alert (wd) ## ==> 第 三 种 方式 


sleep (1) 
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alt.accept () 


wd.close() 


在 上 面 的 几 种 方式 中 ， 这 里 推荐 后 两 种 中 的 任意 一 种 即 可 。 获 取 到 Alert 对 象 之 后 ， 接 


下 来 要 做 的 就 是 对 Alert 对 象 的 操作 ， 那 么 Alert 对 象 又 有 哪些 方法 和 属性 呢 ? 下 面 列 出 了 具 
体 的 列表 。 


口 alert.accept() # 等 同 于 单 击 “确认 ”或 OK。 

口 alert.dismiss() # 等 同 于 单 击 “ 取 消 ”或 Cancel。 

口 alert.authenticate(username,password) # 验证 ， 针 对 需要 身份 验证 的 alert。 

口 alert.send_keys(keysToSend) # 发 送 文本 ， 针 对 有 提交 需求 的 prompt 框 。 

口 alerttext # 获取 alert 文本 内 容 。 

有 了 这 些 方 法 就 可 以 根据 弹出 的 Alert 对 话 框 的 具体 形式 来 调用 相应 的 方法 来 处 理 场 


景 了 。 
6.2.2 ”优雅 地 处 理 Alert 弹 框 


在 处 理 Alert 弹 框 时 仅 知道 获取 和 调用 其 方法 还 不 够 ， 因 为 一 旦 上 下 文 场景 没有 处 理 妥 


善 就 会 抛 出 异常 。 通 常 新 手 会 遇 到 的 异常 有 UnexpectedAlertPresentException 等 。 下 面 就 介 
绍 处 理 Alert 场景 时 ， 如 何 优 雅 地 避免 抛 出 这 些 异 常 。 具 体 请 看 如 下 代码 。 


for 


#!/usr/bin/env python 

ooding: ‘vtt=8 一 “< 

from selenium import webdriver 

from selenium.webdriver.support.ui import WebDriverWait 

from selenium.webdriver.support import expected conditions as EC 
from selenium.common.exceptions import TimeoutException 


browser = webdriver.Chrome() 
browser.get ("file:///C:/Users/Administrator/Desktop/alert.html") 
browser .find element by id("alert").click() 
try: 
WebDriverWait (browser, 3) .untill(EC.alert is present(),'Timed out waiting 

Alert') 

alert = browser.switch to alert() 

alert.accept () 

print "alert accepted" 
except TimeoutException: 

print "no alert" 


这 段 代码 与 6.2.1 节 中 的 代码 的 不 同 点 在 于 ， 这 段 代 码 中 alert 弹 框 具体 有 没有 弹出 都 没 


有 关系 ， 因 为 代码 里 处 理 了 等 待 alert 弹 框 的 机 制 ， 即 浏览 器 等 待 3s，3s 内 alert 弹 框 出 现 则 


单 i 


ff “接受” 按钮， 如果 没有 出 现 则 抛 出 TimeoutException 异常 ， 并 被 捕获 后 处 理 。 
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6.3 ”Selenium 进行 键盘 鼠标 操作 


在 Selenium 的 使 用 中 ， 有 了 时候 会 需要 用 到 一 些 鼠 标 、 键 盘 类 的 用 户 操作 场景 ,例如 ， 快 


捷 键 的 测试 、 鼠 标 右键 、 悬 停 的 测试 等 ， 这 些 在 Selenium 中 都 是 可 以 轻松 完成 的 。 下 面 就 来 
分 别 学 习 如 何 进行 相关 的 操作 。 


6.3.1 键盘 操作 


在 Selenium 中 键盘 操作 需要 用 到 Keys 库 ， 这 个 库 里 面 有 许多 预定 义 的 键盘 按钮 ， 包 括 


26 个 英文 字母 ， 也 包括 回 车 、Tab、Ctrl、Shift、Up、Down 等 特殊 的 功能 键 。 下 面 的 代码 简 
要 地 演示 了 Keys 库 中 元 素 的 使 用 方法 。 


#!/usr/bin/env python 

4 = oding: vis-0 一 “一 

from selenium import webdriver 

from selenium.webdriver.common.keys import Keys 
import time 


driver = webdriver.Chrome () 

driver.get ("file:///C:/Users/Administrator/Desktop/test.html" 
driver.find element by name ("username") .send keys ("1290800466") 
driver.find element by name ("username") .send keys (Keys.TAB 
driver.find element by name ("password") .send_ keys ("15866584957") 
driver.find element by_ name ("password").send keys (Keys .ENTER) 
time.sleep (5) 

driver.close() 


除了 Tab、Enter， 其 他 键盘 操作 的 元 素 值 请 参见 下 面 的 列表 。 这 里 对 它们 进行 了 简单 的 


分 类 ， 首 先是 数学 计算 用 到 的 按键 。 


口 ADD: 加 。 

口 SUBTRACT: 减 。 

口 MULTIPLY: 乘 。 

口 DIVIDE: 除 。 

口 EQUALS: 等 于 。 

口 NUMPAD0 ~ NUMPAD9: 小 键盘 的 0 一 9 数字 。 
接 下 来 是 一 组 常用 的 功能 按键 。 
口 TAB: Tab 键 。 

口 ALT: Alt 键 。 

口 CONTROL : Ctrl 键 。 

口 SHIFT: Shift 键 。 
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口 LEFT_ALT: 左边 Alt 键 。 

口 LEFT_CONTROL: 左边 Ctrl 键 。 
口 LEFT_SHIFT: 左边 Shift 键 。 
口 ENTER: 回 车 键 。 

口 SPACE: 空格 键 。 

口 BACKSPACE: 退 格 键 。 

口 BACK _ SPACE: 退 格 键 。 

口 ESCAPE: Esc 键 。 

口 F1-F12: Fl 一 F12 键 。 

口 INSERT: 插入 键 。 

口 DELETE: 删除 键 。 

口 HOME: 定位 行 首 。 

口 END: 定位 行 尾 。 

下 面 还 有 一 些 方向 相关 的 按键 。 
OUP: 上 。 

口 DOWN: 下 。 

口 LEFT: 左 。 

口 RIGHT: 右 。 

口 ARROW_UP: 向 上 。 

口 ARROW_DOWN: 向 下 。 

口 ARROW_LEFT: 向 左 。 

口 ARROW_RIGHT: 向 右 。 

口 PAGE _ DOWN: 下 一 页 。 

口 PAGE_ UP: 上 一 页 。 
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当然 了 ， 除 了 这 些 常 用 的 按键 之 外 ， 还 有 一 些 不 常用 的 按键 这 里 没有 一 一 罗列 出 来 ， 如 


果 这 些 按键 还 不 够 用 ， 或 者 是 感 兴趣 的 读者 可 以 直接 使 
元 素 。 


6.3.2 ”鼠标 操作 


用 dir(Keys) 命令 来 列 出 所 有 的 按键 


性 


上 面 了 解 了 Selenium 中 键盘 操作 的 使 用 方法 ， 而 与 之 紧密 配合 的 则 是 鼠标 的 操作 。 接 下 
来 继续 来 看 看 Selenium 中 ， 如 何 进 行 鼠标 的 控制 ， 代 码 如 下 。 


#!/usr/bin/env Python 
# -*- coding: utf-8 -*- 
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from selenium import webdriver 

from selenium.webdriver.common.keys import Keys 

from selenium.webdriver.common.action chains import ActionChains 
import time 


Griver = webdriver.Chrome () 

driver.get ("file:///C:/Users/Administrator/Desktop/test.html") 

## 左 键 

submit=driver .find element by id("submit") 

ActionChains (driver) .click (submit) .perform() 

## 右键 

submit=driver .find element_by_id("submit") 

ActionChains (driver) .context click(submit) .Perform() 

## 双击 

submit=driver .find element by id("submit") 

ActionChains (driver) .double click(submit) .perform() 

## 拖 放 到 指定 坐标 位 置 

submit=driver .find element by id("submit") 

ActionChains (driver) .drag and drop by offset (submit, 10, 10) .perform() 

## 拖 放 到 目标 元 素 位 置 

submit=driver .find element_by_id("submit") 

target=driver .find element by id("alert") 

ActionChains (driver) .drag and drop(submit, target) .perform() 

## 鼠标 在 指定 坐标 悬 停 

submit=driver .find element by _ id("submit") 

ActionChains (driver) .move by offset (10, 10) .perform() 

## 和 鼠标 在 指定 元 素 悬 停 

ActionChains (driver) .move_to_element (submit) .Perform() 

## 鼠标 在 指定 元 素 的 指定 坐标 是 停 

submit=driver .find element by id("submit") 

ActionChains (driver) .move_to element with offset(submit, 5, 5).perform() 

## 鼠标 左 键 元 素 并 保持 

submit=driver .find element_by_id("submit") 

ActionChains (driver) .click and hold(submit) .Perform() 

##Ctrltc 拷贝 组 合 件 

ActionChains (driver) .key _ down (Keys.CONTROL) .send keys('c').key up (Keys. 
CONTROL) .perform() 

driver.close() 


上 面 的 操作 基本 包含 日 常 测试 场景 中 会 遇 到 的 一 些 鼠 标的 特殊 操作 ， 包 括 一 些 特 定 的 组 
合 按键 与 单 击 等 。 通 过 这 些 鼠 标 、 键 盘 的 配合 就 可 以 让 我 们 可 以 支持 的 测试 场景 更 加 丰富 和 
健壮 。 


tt 


6.4” 非 Web 控件 的 操作 实现 


在 学 会 了 如 何 使 用 键盘 和 鼠标 操作 之 后 ， 如 果 在 测试 场景 中 遇 到 了 一 些 非常 规 的 Web 控 
件 ， 就 可 以 通过 鼠标 和 键盘 的 组 合 形式 来 模拟 用 户 的 操作 。 例 如 ， 特 定位 置 的 鼠标 单 击 、 文 
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字 输 入 、 组 合 键 使 用 等 场景 。 
下 面 假设 这 样 一 个 场景 : 页 面 中 有 一 个 视频 播放 控件 ,我们 需要 通过 单 | 


播放 完 视频 ， 


之 后 再 来 检查 页 面 上 的 弹出 广告 内 容 。 对 于 这 样 的 场景 可 以 有 多 种 方法 ， 而 最 直接 的 方法 就 


是 把 光标 移动 到 播放 键 的 位 置 ， 然 后 单 击 即 可 。 因 为 视频 播放 控件 是 Flash 对 


象 ， 我 们 无 法 


像 操作 普通 Web 控件 那样 直接 获取 播放 键 对 象 ， 所 以 就 需要 通过 控制 鼠标 的 移动 和 单 击 来 达 


到 模拟 用 户 操作 的 效果 。 具 体 代码 如 下 。 


#!/usr/bin/env Python 

# -*- coding: utf-8 -*- 

from selenium import webdriver 

from selenium.webdriver.common.keys import Keys 

from selenium.webdriver.common.action chains import ActionChains 
import time 


driver = webdriver.Chrome () 

driver.get ("file:///C:/Users/Administrator/Desktop/test.html") 
## 获取 播放 器 控件 

fv=driver.find element by _ id("flvplayer") 

## 获取 播放 器 对 象 的 左上 角 坐 标 、 宽 、 高 

location = flv.location 

size = flv.size 

## 计算 " 播放 " 按钮 的 坐标 位 置 

play x location['x'] + 30 

play_y location['y'] + size['height'] - 35 

## 移动 鼠标 到 按钮 位 置 

ActionChains (driver) .move by offset (play x, play_y) .Perform() 


ActionChains (driver) .click() .perform() 


driver.close() 


上 述 代码 中 首先 获取 播放 器 对 象 ， 其 次 通过 location 属性 获取 到 它 的 坐标 位 置 ， 再 通 


过 size 属性 获取 到 它 的 宽 和 高 ， 这 样 就 可 以 计算 出 “播放 ”按钮 的 绝对 位 置 
move_by_offset 方法 把 鼠标 移动 到 该 位 置 ， 最 后 执行 下 左 键 操作 即 可 。 


提示 除了 上 述 列 出 的 方法 ， 完 成 这 个 场景 还 有 其 他 可 选 的 方法 ， 但 是 需 
属性 比较 了 解 。 例 如 ， 部 分 站 点 的 视频 播放 可 以 通过 Space 键 来 控制 ， 那 么 我 
发 送 一 个 Space 键 给 播放 控件 对 象 ， 代 码 如 下 。 


ActionChains (driver) .send keys (Keys.SPACE, flv) .perform() 
flv.send_ keys (Keys.SPACE) 


， 之 后 再 通过 


要 我 们 对 业务 
们 就 可 以 直接 
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6.5 Selenium 执行 JavaScript 及 操作 DOM 


Selenium 中 已 经 封装 了 很 多 常用 的 方法 和 接口 ， 但 总 会 有 些 情况 或 者 业务 场景 需要 我 们 


进行 一 些 非常 规 的 操作 ， 而 此 时 只 能 通过 一 些 非常 规 的 方法 才能 实现 ， 这 里 称 之 为 Geek 的 
方法 。 例 如 ， 通 过 Selenium 执行 JavaScript 操作 。 


了 解 JavaScript 的 读者 都 知道 ， 它 主要 是 在 浏览 器 中 执行 并 且 可 以 操作 DOM 的 一 种 脚 


本 语言 ， 通 常 Web 页 面 上 的 动态 效果 都 是 由 JavaScript 来 实现 的 。 可 以 这 么 说 ， 用 户 能 够 对 
页 面 所 做 的 操作 ，JavaScript 都 可 以 做 到 ， 用 户 做 不 到 的 操作 JavaScript 也 可 以 做 到 ， 所 以 说 
Selenium 提供 了 这 个 接口 ， 就 相当 于 我 们 又 掌握 了 一 把 打开 新 世界 的 钥匙 。 


顺便 说 一 下 ，Seleniuml 的 核心 驱动 就 是 JavaScript 实现 ， 所 以 可 以 想象 JavaScript 在 


Selenium 中 可 以 直接 使 用 的 益处 可 见 一 斑 。 那 么 接 下 来 就 学 习 下 如 何 通过 Selenium 使 用 
JavaScript， 示 例 代码 如 下 。 


#!/usr/bin/env Python 

= Goding: tte8 =*= 

import time 

from selenium import webdriver 


driver = webdriver.Chrome () 

driver.get ("file:///C:/Users/Administrator/Desktop/test.html") 
driver.execute script('alert ("ok")') 

alt = driver.switch to.alert 

time.sleep (1) 

alt.accept () 

print driver.execute script('return 1+1') 

driver.close() 


上 述 代 码 中 ， 通 过 execute_script 方法 就 可 以 直接 执行 一 段 JavaScript 代码 来 动态 地 调 出 


提示 框 ; 另外 还 可 以 执行 一 个 表达 式 ， 并 且 把 执行 的 结果 返回 到 Selenium 中 ， 由 此 可 以 知道 
在 执行 其 他 需求 的 JavaScript 代码 时 也 是 可 行 的 。 除 了 上 面 的 方法 ，Selenium 还 提供 了 异步 
执行 JavaScript 的 接口 ， 该 方法 可 以 用 来 发 送 AJAX 请 求 并 接受 响应 内 容 ， 具 体 代码 如 下 。 


i Oil EF-=8 =»= 
import time 
from selenium import webdriver 


driver = webdriver.Chrome () 
driver.get ("file:///C:/Users/Administrator/Desktop/test.html") 
## 设置 脚本 执行 超时 时 间 ， 默 认 是 0 
driver.set script timeout (5) 
driver.execute async_script(''' 
var callback = arguments[arguments.length - 1]; 
Var xhr = new XMLHttpRequest (); 
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xhr.open('GET', 'http://test.url', true); 
xhr.onreadystatechange = function() { 

if (xhr.readyState == 4) { 

callback (xhr.responseText); 

} 
} 
xhr.send(); 

""') 


driver.close() 


上 述 代 码 中 的 JavaScript 是 一 段 发 送 AJAX 的 代码 ， 只 要 在 5s 内 能 够 返回 则 正常 ， 否 则 
会 报 Timeout 异常 。 另 外 ，JavaScript 代码 中 arguments 是 获取 代码 参数 的 接口 ， 我 们 自己 也 
可 以 传递 参数 到 这 个 数组 ， 代 码 如 下 。 


driver.execute async script(''' 
alert (arguments[0]); 
alert (arguments[1]); 
'', 'java', 'python') 


上 述 代 码 中 ，arguments 的 第 一 个 参数 接收 的 是 Java 字符 ， 第 二 个 参数 接收 的 是 Python 


字符 。 另 外 ， 默 认 的 arguments 的 最 后 一 个 参数 始终 是 一 个 callback 函数 。 因 此 在 上 一 段 代 
码 里 虽然 没有 传 参 数 ， 但 还 是 可 以 获取 到 callback 函数 。 


注意 在 发 送 AJAX 的 时 候 ， 由 于 跨 域 安 全 的 问题 ，URL 只 能 是 同一 个 域 下 面 的 URL 
地 址 ， 否 则 会 报 JavaScript 的 跨 域 访问 异常 。 


6.6 ”Selenium 截屏 操作 


在 执行 自动 化 测试 的 时 候 ， 无 论 是 对 既定 场景 的 界面 检查 ， 还 是 对 发 生 错 误 的 场景 进行 
保存 ， 都 需要 进行 的 一 种 操作 就 是 截屏 。 有 了 截屏 很 大 程度 上 可 以 辅助 我 们 进行 测试 结果 的 
评判 和 错误 场景 的 断定 ， 能 够 有 效 地 帮助 脚本 执行 后 推断 素材 。 接 下 来 看 看 如 何 使 用 截屏 功 
能 ， 代 码 如 下 。 


#!/usr/bin/env python 

天 = CDiLAg: te- .< 

import time 

from selenium import webdriver 


driver = webdriver.Chrome () 
driver.maximize window() 
driver.get ("file:///C:/Users/Administrator/Desktop/test.html") 
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driver.save_screenshot ('demo.png') 
driver.close() 


上 述 代 码 中 代码 执行 结束 后 会 在 当前 文件 夹 下 保存 一 张 名 为 demo.png 的 图 片 。 这 里 需 
要 注意 的 是 ， 该 方法 只 能 截图 可 见 区域 的 页 面 内 容 ， 不 在 浏览 器 可 见 区 域 的 内 容 则 无 法 截 
屏 。 而 对 于 想 要 截取 完整 页 面 的 ， 则 可 以 通过 PhantomJS 浏览 器 来 达到 截取 全 屏 的 目的 。 具 
体 代码 如 下 。 

#!/usr/bin/env python 


# -*- coding: utf-8 -*- 
from selenium import webdriver 


driver = webdriver.PhantomJS () 

driver.get ("file:///C:/Users/Administrator/Desktop/test.html") 
driver.save_screenshot ('demo.png') 

driver.close() 


注意 ”如果 想 要 执行 上 面 的 代码 ， 需 要 安装 PhantomJS 的 驱动 ， 官 方 地 址 为 http:// 
phantomjs.org/。 可 以 下 载 到 exe 文件， 解压 后 直接 复制 到 Python 的 Scripts 目录 即 可 ， 即 与 
IE、Chrome 的 driver 放 在 同一 个 目录 。 
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UnitTest 单元 测试 框架 


正如 Java 拥有 JUnit 一 样 ， 每 一 个 语言 都 有 一 个 用 于 单元 测试 的 工具 包 ， 可 以 使 用 它 来 
进行 单元 测试 用 例 的 开发 和 测试 。 同 样 ， 由 于 其 执行 用 例 的 逻辑 也 可 以 移植 到 Web 自动 化 的 
测试 上 来 。 因 此 ， 本 章 就 来 学 习 下 Python 的 单元 测试 框架 UnitTest。 


7.1 常规 使 用 方式 


在 正式 开始 代码 学 习 之 前 ， 先 来 了 解 一 下 关于 单元 测试 框 的 几 个 概念 ， 即 Test Case、 
Test Suite 、Test Runner、Test Fixture。 单 元 测试 基本 是 由 这 几 个 重要 部 分 组 成 的 。 

口 Test Case: 测试 用 例 ， 即 一 个 完整 流程 的 测试 场景 ， 包 括 环境 初始 化 与 恢复 。 

口 Test Suite: 由 多 个 Test Case 组 成 的 一 套 测试 用 例 集 ， 主 要 用 于 归档 执行 。 

口 Test Runner: 用 来 执行 Test Case 与 Test Suite 的 部 件 。 

口 Test Fixture : 测试 装置 ， 主 要 指 的 是 测试 前 后 需要 做 的 一 些 事情 ， 通 常 都 在 setUp 和 

tearDown 函数 中 执行 。 

了 解 了 这 几 个 概念 之 后 ， 就 可 以 大 概 知道 单元 测试 框架 的 基本 流程 就 是 ， 创 建 一 个 Test 
Case 并 配置 好 对 应 的 Test Fixture， 然 后 添加 到 Test Suite 中 ， 最 后 由 Test Runner 来 加 载 并 执 
行 。 接 下 来 从 Test Case 开始 学 习 单 元 测试 框架 。 示 例 代码 如 下 。 


import random 
import unittest 
class TestSequenceFunctions (unittest.TestCase): 
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def setUp (self) : 
self.seq = range(10) 
def test_choice (self) : 
element = random.choice (self.seqg) 
self.assertTrue (element in self.seq) 
def test sample (self): 
with self.assertRaises (ValueError): 
random.sample (self.seq, 20) 
for element in random.sample(self.seq, 5): 
self.assertTrue (element in self.seq) 
def tearDown (self): 
self.seq = None 
if _name == '_ main_': 
unittest.main() 


上 述 代 码 中 是 一 个 Test Case 文件 里 面包 含 两 个 测试 方法 ， 所 有 的 测试 方法 都 必须 以 test 
开头 ， 这 样 才能 被 认为 是 测试 方法 。 另 外 ， 还 有 一 个 setUp 和 一 个 tearDown 方法 。setUp 主 
要 就 是 用 来 进行 测试 环境 的 ， 而 tearDown 则 是 进行 测试 环境 清理 操作 的 ， 它 们 就 是 前 面 提 
到 的 Test Fixture。 除 了 这 两 个 方法 ，setUpClass、tearDownClass 方法 对 应 的 是 Class 执行 前 
后 要 做 的 事情 。 最 后 一 个 重要 的 地 方 就 是 assert 断言 语句 ， 例 如 代码 中 的 assertTrue， 用 来 断 
言 测试 结果 为 True， 相 似 的 断言 语句 还 有 很 多 ， 用 来 针对 不 同 的 测试 结果 进行 断言 。 

如 果 对 测试 用 例 整 体 执行 的 流程 和 顺序 还 不 是 很 明确 ， 可 以 通过 下 面 的 示例 代码 进一步 
理解 。 


import unittest 
class ExampleOrderTestCase (unittest.TestCase): 
def setUp(self): 
print 
print 'I am setUp' 
def tearDown (self): 
print 'I am tearDown' 
def test do_ something(self): 
print 'I am test do_ something' 
def test do something else(self): 
print 'I am test do_something else' 


if _name =='_ main_': 
unittest.main (verbosity=2) 
上 述 代 码 的 执行 结果 如 下 。 
test do something (_ main .ExampleOrderTestCase) 
I am setUp 


I am test do_ something 

I am tearDown 

ok 

test_do_ something else (_main .ExampleOrderTestCase) 
I am setUp 
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I am test do _ something else 
I am tearDown 
ok 


从 结果 中 可 以 看 到 ，setUp 和 tearDown 被 执行 了 两 次 ， 也 就 是 每 一 个 测试 方法 执行 的 前 
后 都 会 被 调用 。 此 外 ,在 setUp 和 tearDown 方法 中 如 果 出 现 了 failure 或 者 error， 那 么 当 次 
的 测试 就 会 出 现 error ; 而 如 果 在 testXXX 方法 中 即使 出 现 了 failure 或 者 error，tearDown 方 
法 中 的 代码 始终 都 会 被 执行 。 


提示 failure 即 指 测试 代码 中 的 assert 断言 失败 ， 例 如 ，assertTrue(False) ; error 即 指 测 
试 代码 中 的 语法 错误 ， 例 如 1/0。 


7.2 ”测试 套件 使 用 


前 面 已 经 提 到 过 Test Suite 的 概念 ， 即 测试 套件 ， 也 就 是 用 来 归档 和 整理 Test Case 的 
集合 ， 方 便 我 们 在 执行 用 例 时 按 需 进 行 用 例 的 分 类 和 执行 。 首 先 看 下 测试 套件 的 基本 使 用 方 
法 ， 如 以 下 代码 所 示 。 


#-*= encoding:; UTF-b —*= 
import unittest 
class ExampleTestCase (unittest.TestCase): 
def test do_ somthing (self): 
self.assertEqual (1, 1) 
def test do somthing elsel(self): 
self.assertEqual (1, 1) 
class AnoterExampleTestCase (unittest.TestCase): 
def test do_ somthing(self): 
self.assertEqual (1, 1) 
def test_do_somthing_else(self) : 
self.assertEqual(1，1) 
def suite_use_make_suite() : 
suite = unittest.TestSuite() 
suite.addTest (unittest .makeSuite (ExampleTestCase)) 
return suite 
def suite add one test(): 
suite = unittest.TestSuite() 
suite.addTest (ExampleTestCase('test do _ somthing')) 
return suite 
def suite use test loader(): 
test_ cases = (ExampleTestCase, AnoterExampleTestCase) 
suite = unittest.TestSuite() 
for test Case in test cases: 
tests = unittest.defaultTestLoader 
.loadTestsFromTestCase (test_case) 
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suite.addTests (tests) 
return suite 
if name ==" main _': 
unittest.main(defaultTest='suite use test loader') 


从 上 述 代码 中 可 以 看 出 ，TestSuite 有 两 种 方式 用 来 添加 测试 用 例 ， 一 种 是 addTest， 一 
种 是 addTests， 分 别 用 来 添加 单个 测试 对 象 和 一 组 测试 对 象 。 其 中 ， 这 个 测试 对 象 可 以 是 
一 个 测试 方法 ， 或 者 是 一 个 测试 套件 ; 代码 中 的 第 一 种 addTest 方法 添加 的 测试 对 象 就 是 
一 个 测试 套件 ， 这 个 测试 套件 包含 ExampleTestCase 类 中 的 所 有 测试 方法 。 代 码 中 第 二 种 
addTest 方法 指定 了 特定 的 测试 方法 ， 所 以 这 里 的 测试 对 象 就 是 测试 方法 test_do_something。 
代码 中 addTests 方法 直接 一 次 添加 了 多 个 测试 方法 ， 同 理 ，addTests 也 可 以 同时 添加 多 个 测 
试 套件 。 

了 解 Test Suite 的 基本 使 用 方法 之 后 ， 再 来 看 看 获取 Test Suite 实例 的 方式 。 第 一 种 就 是 
上 述 代码 中 直接 实例 unittest.TestSuite 类 的 方式 来 获取 一 个 空 Test Suite 容器 ; 第 二 种 是 上 述 
代码 中 的 unittest.makeSuite 方法 ， 通 过 一 个 TestCase 类 来 生成 一 个 Test Suite 并 包含 该 测试 
类 中 的 所 有 测试 方法 。 接 下 来 再 看 下 Test Suite 其 他 的 获取 方式 。 


class ExampleTestSuite (unittest.TestSuite) : 
def _init (self): 
unittest.TestSuite. init_ (self 
map (ExampleTestCase, 
("test_do_something", 
"test do something else"))) 
suite = ExampleTestSuite() 


从 上 述 代码 中 可 以 看 到 ， 这 里 是 通过 继承 TestSuite 类 来 实现 的 ， 并 且 在 实例 化 父 类 
的 时 候 指 定 测试 类 与 测试 方法 并 加 载 到 TestSuite 容器 中 。 此 外 ， 还 有 一 种 方式 也 是 实例 化 
TestSuite 类 ， 但 是 可 以 带 上 参数 来 添加 到 实例 的 Test Suite 中 ， 具 体 代 码 如 下 。 


suitel = unittest.makeSuite (ExampleTestCase) 
suite2 = unittest.makeSuite (AnoterExampleTestCase) 
alltests = unittest.TestSuite((suitel, suite2)) 
tests = unittest.defaultTestLoader 
.loadTestsFromTestCase (ExampleTestCase) 

alltests2 = unittest.TestSuite (tests) 


7.3 ”TestLoader 的 使 用 


关于 TestLoader 在 7.2 节 中 已 经 见识 过 ， 通 过 它 可 以 从 一 个 测试 类 中 获取 测试 方法 ， 例 
如 ，loadTestsFromTestCase 方 法 就 可 以 用 来 从 单个 测试 类 中 加 载 测试 方法 。 而 除 此 之 外 ， 
TestLoader 还 有 其 他 几 种 方式 来 加 载 测试 方法 ， 本 节 就 来 了 解 一 下 。 首 先 可 以 通过 dir 命令 来 
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查看 TestLoader 的 成 员 方 法 ， 其 结果 如 图 7-1 所 示 。 


etattribut 


shook 


t_module 


’_get_name_f 
| 


tMethodPre 


图 7-1 Python 查看 对 象 成 员 
由 此 可 知 ，TestLoader 对 象 除了 前 面 见 到 过 的 loadTestsFromTestCase 之 外 ， 还 有 如 下 几 


个 加 载 测试 方法 的 成 员 。 


口 loadTestsFromModule: 从 模块 中 加 载 测 试 ， 即 Python 文件 。 

口 loadTestsFromName : 从 名 字 中 加 载 测试 ， 这 个 名 字 可 以 是 Module、TestCase 类 ， 测 
试 方法 ， 亦 或 是 一 个 可 调用 的 返回 测试 用 例 或 测试 套件 的 实例 。 

口 loadTestsFromNames: 同上 ， 可 以 一 次 接受 多 个 name 的 序列 。 

可 以 假设 目前 有 两 个 单元 测试 文件 ， 其 内 容 分 别 如 以 下 两 个 代码 清单 所 示 。 


代码 清单 7-1 Test1.py 


import unittest 
class TestCasel (unittest.TestCase): 
def setUp (self) : 
print 'setUPp' 
def test sample (self): 
print 'i am in Testl' 
def tearDown (self): 
print 'teardown' 


代码 清单 7-2 Test2.py 


import unittest 
class TestCase2 (unittest.TestCase): 
def setUp (self) : 
print 'setUp' 
def test_ sample (self): 
Print ?二 ,am in Test2" 
def tearDown (self): 
print 'teardown'" 


现在 可 以 通过 上 面 提 到 的 三 种 方法 进行 测试 用 例 的 加 载 ， 代 码 如 下 。 


import unittest 
import Test1 
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loader = unittest.defaultTestLoader 

test1 loader.loadTestsFromModule (Test1) 

test2 loader.loadTestsFromName ('Test1') 

test3 loader.loadTestsFromName ('Testl.TestCasel') 

test4 loader.loadTestsFromName ('"Testl.TestCasel.test_sample') 
test5 loader.loadTestsFromNames(['Testl', 'Test2']) 


7.4 ”UnitTest 加 载 流 程 


到 此 为 止 ， 我 们 已 经 掌握 了 UnitTest 的 基本 概念 与 使 用 方法 ， 最 后 总 结 一 下 UnitTest 的 
加 载 与 执行 的 整个 流程 。 在 此 之 前 先 看 下 UnitTest 的 最 后 一 个 概念 TestRunner， 即 用 来 执行 
Test Suite 的 执行 器 ， 通 常 启动 TestRunner 的 方式 如 下 。 


runner = unittest.TextTestRunner () 
runner .run (test_suite) 


现在 可 以 理 清 UnitTest 的 执行 流程 了 。 具 体 顺序 为 : 编写 带 有 测试 方法 的 TestCase 类 ， 
通过 显 式 或 隐 式 的 方式 调用 TestLoader 来 加 载 要 执行 的 TestCase 类 或 方法 ， 加 载 完 成 之 后 再 
添加 到 TestSuite 容器 中 ， 最 后 再 使 用 TestRunner 来 执行 TestSuite 中 的 测试 用 例 。 

对 于 7.1 节 代 码 清 单 中 的 执行 顺序 也 是 如 此 ， 只 是 所 有 流程 都 隐 式 地 封装 在 UnitTest 的 
main 方法 里 了 。 
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分 层 框架 设计 与 实现 


在 刚 开始 学 习 自 动 化 测试 的 时 候 ， 都 是 从 一 个 简单 的 测试 用 例 脚本 开始 的 ， 所 有 的 测试 
数据 都 是 包含 在 一 个 文件 甚至 是 一 个 测试 用 例 里 面 。 当 我 们 再 继续 写 下 一 个 用 例 的 时 候 ， 最 
简单 的 就 是 复制 一 份 代码 然后 根据 业务 情况 来 修改 一 下 测试 代码 。 最 常见 的 测试 用 例 代 码 格 
式 如 代码 清单 8-1 所 示 。 


代码 清单 8-1 ”无 分 层 结构 测试 用 例 


#!/usr/bin/env Python 

# -*- coding: utf-8 -*- 

from selenium import webdriver 

from selenium.webdriver.common.alert import Alert 
from time import sleep 


wd = webdriver.Chrome () 
wd.get (r'http://www.baidu.com') 


wd.find element_by_id('kw').send_keys ("selenium") 
wd.find element_by_ id('su').click() 

sleep (1) 

assert 'selenium' in wd.title 

wd.close () 


可 以 看 到 ， 测 试 使 用 的 定位 符 、 输 入 数据 、 期 望 结 果 等 都 在 测试 用 例文 件 中 。 一 旦 这 些 
数据 有 变动 需要 修改 ， 我 们 只 好 逐一 地 修改 每 一 处 的 测试 代码 。 当 然 在 只 有 几 个 测试 场景 的 
情况 下 ,没有 太 大 的 问题 ， 而 当 用 例 数量 变 得 庞大 的 时 候 ， 我 们 在 维护 脚本 的 时 候 就 开始 凸 
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显 出 问题 了 。 同 时 ， 我 们 可 能 还 有 很 多 重复 的 业务 代码 没 进行 分 离 和 提取 ， 当 这 部 分 代码 需 
要 维护 时 ， 工 作 量 也 会 成 倍增 加 。 

因此 ， 当 一 开始 就 准备 实施 一 个 较 大 型 或 者 较 多 数量 的 自动 化 测试 时 ， 就 需要 对 测试 工 
具 、 测 试 技术 和 测试 框架 进行 选 型 和 设计 ， 以 便 在 业务 扩展 和 变化 的 情况 下 能 够 及 时 响应 ， 
使 用 尽量 短 的 时 间 来 完成 存量 测试 用 例 维护 的 工作 。 本 章 主要 讲解 如 何 设计 一 个 良好 的 测试 
框架 ,其 核心 思想 是 把 本 来 写 在 一 个 测试 用 例 里 的 业务 进行 分 层 拆 解 ， 把 不 同 的 数据 类 型 、 
业务 模型 进行 分 离 ， 降 低 业务 与 数据 间 的 耦合 度 ， 提 高 测试 脚本 的 可 维护 性 。 

下 面 看 下 一 般 分 层 框架 都 具有 哪些 基础 结构 ， 如 图 8-1 所 示 的 框架 就 是 一 个 比较 通用 的 
分 层 框架 的 结构 。 其 主要 包括 定位 符 驱动 层 、 页 面 操作 层 、 业 务 逻 辑 层 、 异 常 处 理 层 、 数 据 
驱动 层 、 结 果 驱 动 层 等 六 大 模块 。 其 中 ,测试 用例 层 则 是 需要 开发 的 测试 用 例 。 


图 8-1 通用 分 层 框架 结构 图 


图 8-1 中 垂直 、 水 平方 向 都 有 三 层 结构 ， 把 不 同 功能 模块 、 业 务 数据 都 进行 了 分 离 。 同 
时 ， 针 对 业务 也 进行 了 分 层 ， 让 每 一 份 代码 始终 只 有 一 个 出 处 。 分 模块 和 分 层 的 好 处 在 于 当 
测试 需求 有 变化 的 时 候 ， 始 终 只 需 改动 特定 模块 内 部 的 代码 即 可 ， 修 改 所 带 来 的 影响 对 模块 
外 的 其 他 模块 是 透明 的 。 例 如 ， 如 果 页 面 元 素 的 定位 属性 变 了 ， 只 要 修改 定位 符 驱 动 层 的 数 
据 即 可 ; 再 如 ， 某 个 页 面 元 素 的 操作 需要 增加 延 时 等 待 ， 只 需要 在 页 面 操作 层 添 加 延 时 语句 
即 可 。 接 下 来 逐一 了 解 具体 的 框架 逻辑 与 代码 实现 。 


8.1 数据 驱动 层 


测试 数据 驱动 层 主要 是 用 来 提供 测试 数据 的 独立 存储 。 具 体 的 数据 可 以 来 自 文本 文件 ， 
例如 ，TXT、XML 等 ; 也 可 以 来 自 数据 库 ， 如 SQLite、MySQL 等 。 本 节 就 来 详细 介绍 下 测 
试 数据 层 的 设计 与 使 用 方法 。 本 章 将 根据 不 同 的 存储 方式 分 为 两 节 来 分 别 进行 介绍 。 
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8.1.1 文件 存储 


文件 存储 即 把 测试 数据 直接 存放 在 独立 的 文本 文件 中 ， 可 以 是 TXT 文件 、CSV 文件 、 
XML 文件 、JSON 文 件 等 。 因 为 我 们 使 用 的 语言 为 Python， 在 这 里 选择 的 存储 文件 直接 就 是 
Python 文件 ， 其 优点 是 省 去 了 对 数据 文件 进行 解析 的 步 又。 而 对 测试 数据 的 管理 有 其 他 要 求 
的 情况 ， 则 可 以 根据 具体 的 需求 来 选择 最 合适 的 方式 。 

接 下 来 就 基于 代码 清单 8-1， 来 学 习 如 何 分 离 测试 数据 驱动 层 。 首 先 确 定 下 代码 清单 8-1 
中 需要 分 离 的 测试 数据 。 由 于 代码 清单 8-1 非常 简单 ， 需 要 分 离 的 数据 只 有 两 处 ， 一 处 是 输 
入 URL 地 址 ， 另 一 处 则 是 输入 搜索 关键 字 。 其 对 应 的 代码 如 下 所 示 。 


wd.get (r'http://www.baidu.com') 
wd.find element_by_id('kw') .send_ keys("selenium") 


其 中 ,“ http://www.baidu.com” 就 是 URL 地 址 内 容 ,“selenium” 则 是 需要 在 页 面 上 输 
和信 的 搜索 关键 字 。 它 们 都 是 用 户 的 输入 数据 ， 也 就 是 需要 被 分 离 的 测试 数据 内 容 。 这 里 把 它 
们 分 离 到 一 个 独立 的 Python 测试 数据 文件 里 ， 假 设 名 为 DataPool.py， 则 内 容 格式 如 下 。 


#!/usr/bin/env Python 
OG UtE-6 


DataPool = { 
'BAIDU_HOME URL' : 'http://www.baidu.com', 


'SELENIUM' : 'selenium', 


$ 


可 以 看 出 测试 数据 文件 的 内 容 非 常 简单 ， 只 有 一 个 DataPool 的 字典 变量 ， 并 在 该 字典 中 
添加 了 若干 条 测试 数据 。 编 写 好 Python 数据 文件 之 后 ， 把 它 保存 到 与 测试 用 例文 件 相同 的 目 
录 。 而 在 具体 的 用 例 层 代码 里 我 们 的 引入 和 使 用 方式 如 下 所 示 。 


from DataPool import DataPool as dp ## 引入 测试 数据 


= 


dp.get ('BAIDU_HOME_URL') ## 获取 具体 的 测试 数据 
而 代码 清单 8-1 经 过 数据 分 离 之 后 的 更 新 代码 如 代码 清单 8-2 所 示 。 
代码 清单 8-2 有 数据 分 离 的 测试 用 例 


#!/usr/bin/env python 

= Colings EE-B ~ 

from selenium import webdriver 

from selenium.webdriver.common.alert import Alert 
from time import sleep 

from DataPool import DataPool as dp 
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wd = webdriver.Chrome () 
wd.get (dp.get ('BAIDU HOME URL')) 


wd.find element by id('kw').send keys (dp.get('SELENIUM')) 
wd.find element by id('su').click() 

sleep (1) 

assert dp.get('SELENIUM') in wd.title 

wd.close() 


当然 ， 由 于 上 面 的 测试 数据 非常 少 ， 可 以 把 所 有 的 测试 数据 都 放 在 一 个 文件 内 ; 而 在 正 
式 的 自动 化 测试 项 目 中 ， 还 需要 给 测试 数据 进行 分 类 管理 。 例 如 ， 一 个 测试 用 例文 件 使 用 一 
个 独立 的 测试 数据 文件 ;而 对 于 大 部 分 用 例 都 需要 用 到 的 测试 数据 可 以 单独 提取 到 一 个 公共 
测试 数据 文件 中 ， 这 样 可 以 更 好 地 确保 测试 数据 的 统一 性 。 


8.1.2 数据库 存储 


数据 库存 储 即 把 测试 数据 直接 存储 在 数据 库 中 ， 例 如 ，SQLite、MySQL 等 都 是 可 选 的 
对 象 。 相 对 于 文件 存储 来 说 ， 数 据 库 存储 更 加 易于 对 数据 进行 管理 和 设计 。 缺 点 则 是 我 们 需 
要 做 额外 的 工作 来 支持 。 例 如 ， 数 据 库 的 安装 、 数 据 库 驱 动 的 安装 、 数 据 库 读 取代 码 的 开 
发 、 测 试 数据 获取 方法 的 封装 等 。 

本 节 以 MySQL 为 例 来 讲解 如 何 从 数据 库 中 获取 测试 数据 ， 其 步骤 大 概 如 下 。 

(1 ) 安装 MySQL。 

(2 ) 安装 Python 的 MySQL 驱动 。 

(3 ) 数据 库 读 取代 码 开发 。 

(4 ) 测试 数据 表 的 设计 。 

(5 ) 测试 数据 获取 方法 封装 。 

〈6 ) 测试 数据 层 的 引入 与 使 用 。 


1. 安 装 MySQL 

MySQL 的 安装 步骤 如 下 。 

(1 ) 进入 MySQL 下 载 页 面 http://dev.mysql.com/downloads/mysql/。 
(2 ) 下 载 对 应 的 安装 文件 ， 本 文 为 Windows 的 32 位 版 本 。 

(3 ) 双击 下 载 的 文件 。 

〈4 ) 直接 默认 或 选择 安装 目录 进行 安装 。 

(5 ) 设置 MySQL 的 root 密码 。 

(6) 完成 安装 并 使 用 下 面 的 命令 进行 测试 。 


mysql -u root -p${youpassword} ## 替换 为 你 设置 的 密码 


第 8 章 分 层 框架 设计 与 实现 余 177 


(7) 如 果 正 常 进入 MySQL 提示 符 界 面 则 表示 安装 成 功 。 


2. 安 装 Python 的 MySQL 驱动 
在 前 面 的 章节 中 已 经 介绍 过 了 Python 环境 的 安装 及 pip 的 安装 ， 因 此 我 们 在 MySQL 驱 


动 的 时 候 就 可 以 直接 使 用 pip 来 进行 安装 ， 具 体 安装 命令 如 下 。 


pip install MySQL-python 


安装 完成 后 可 以 通过 pip list 命令 来 查看 是 否 正 确 安装 。 


3. 数据 库 读 取 代码 开发 
MySQL 数据 库 和 驱动 都 安装 完成 后 ， 需 要 测试 下 环境 是 否 搭建 成 功 ， 并 编写 数据 库 读 


取 的 代码 ， 测 试 的 具体 代码 见 代 码 清单 8-3。 


癌 


代码 清单 8-3 ”MySQL 数据 测试 代码 


#!/usr/bin/python 
= codtng; UPF-B 一 


import MySQLdb 


db = MySQLdb.connect ("localhost", "root", "root", "test" ) ## 数据 库 连接 
cursor = db.cursor1() ## 获取 游标 
cursor.execute ("SELECT VERSION () ") ## 执行 SQL 语句 
data = cursor.fetchone() ## 获取 一 条 查询 结果 数据 
print "Database version : %s " $ data 

db.close() ## 关闭 连接 


上 面 的 代码 执行 后 如 果 能 正常 打印 出 数据 库 的 版 本 ， 则 表示 数据 库 相 关 的 环境 搭建 成 


; 接 下 来 就 可 以 把 这 段 代 码 封装 到 DataPool 类 的 方法 中 ， 具 体 的 代码 见 代码 清单 8-4。 


代码 清单 8-4 ”DataPool 类 


#!/usr/bin/python 
codings UTD- -一 二 一 


import MySQLdb 
class DataPool (object): 


@staticmethod 
def select data(sql): 
db = MYSOLdb .connect ("localhost", "root", "root", "test" ) ## 数据 库 连 接 
cursor = db.cursor() ## 获取 游标 
cursor.execute (sql) ## 执行 SQL 语句 
data = cursor.fetchone() ## 获取 一 条 查询 结果 数据 
db.close() 


return data 
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封装 后 的 代码 可 以 直接 通过 DataPool.select_data 方法 来 进行 数据 库 的 查询 操作 ， 唯 一 需 
要 传人 的 参数 则 是 具体 的 SQL 查询 语句 ， 而 后 面 的 步骤 则 会 设计 出 具体 的 SQL 内 容 。 
4. 测试 数据 表 的 设计 
测试 数据 表 指 的 是 用 来 存放 测试 数据 的 具体 的 表 ， 这 个 表 的 结构 需要 提前 设计 好 ， 并 在 
数据 库 中 进行 创建 ， 之 后 就 可 以 往 表 中 添加 具体 的 测试 数据 ， 然 后 再 通过 DataPool 类 的 具体 
方法 来 获取 测试 数据 。 
由 于 我 们 的 表 是 用 来 存放 测试 数据 的 ， 因 此 表 结 构 是 非常 简单 的 ， 只 需要 设计 一 些 存放 
测试 数据 的 字段 即 可 ， 具 体 的 数据 库 、 数 据 表 的 创建 语句 大 致 可 以 如 下 。 
CREATE DATABASE datapool; 
use datapool; 
CREATE TABLE ‘test data ( 
“id* int(255) NOT NULL AUTO_INCREMENT, 
“modle ”varchar (255) DEFAULT NULL COMMENT ' 模块 名 '， 
`test_case、”varchar (255) NOT NULL COMMENT ' 测试 用 例 名 称 '， 
“name ”varchar (255) NOT NULL COMMENT '， 测试 数据 名 '， 
“value ”varchar (255) NOT NULL COMMENT ' 测试 数据 的 值 '， 
“desc”、varchar (255) DEFAULT NULL COMMENT ' 测试 数据 的 描述 '， 
`result ”text COMMENT ' 对 应 的 测试 期 望 结果 '， 
“status”enum('active', 'inactive') DEFAULT 'active' COMMENT ' 数据 是 否 有 效 '， 
“createAt、date DEFAULT NULL COMMENT ' 创建 日 期 '， 
PRIMARY KEY (“id*), 
UNIQUE KEY ‘test case. (‘test case', ‘name’) 
) ENGINE=InnoDB DEFAULT CHARSET=utf8; 
具体 而 言 ， 首 先 创建 了 一 个 名 为 datapool 的 数据 库 ， 然 后 进入 datapool 数据 库 并 创建 了 
一 个 名 为 test_data 的 表 。 表 的 字段 有 模块 名 、 测 试用 例 名 称 、 测 试 数据 名 、 测 斌 数据 的 值 、 
测试 数据 的 描述 、 对 应 的 测试 期 望 结 果 、 数 据 是 否 有 效 及 创建 日 期 。 其 中 ，test_case、name、 
value 为 必 填 项 ， 且 test_case 与 name 字段 为 联合 唯一 键 ， 即 同一 个 用 例 下 不 能 有 同名 的 测试 
数据 存在 。 
通过 对 数据 表 的 简单 设计 ， 就 可 以 对 测试 数据 进行 一 些 简 单 的 管理 了 。 例 如 ， 按 照 模块 
进行 数据 的 分 类 、 按 照 用 例 对 数据 进行 分 类 、 对 重复 数据 进行 限制 、 对 数据 的 有 效 性 进行 设 
置 。 更 多 关于 测试 数据 、 测 试 结果 管理 的 设计 ， 有 兴趣 的 读者 可 以 更 加 深入 地 研究 ， 也 可 以 
到 http://www.testdoc.org 上 来 进行 探讨 。 


5. 测试 数据 获取 方法 封装 
数据 表 设 计 好 之 后 我 们 就 知道 如 何 去 读 取 测 试 数据 了 。 为 了 能 够 兼容 代码 清单 8-2 的 测 
试 代码 ， 需 要 把 测试 数据 获取 的 方法 封装 成 一 致 的 接口 。 具 体 的 完整 代码 见 代 码 清单 8-5。 
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代码 清单 8-5 ”封装 MySQL 的 DataPool 类 


#!/usr/bin/env Python 

和 EGG =*= 

import MySQLdb 

from ExceptionWarpper import NOTESTDATAERROR 


class DataPool (object) : 


def 


def 


def 


init_ (self, test_ case, module=None): 
self.test case = test_case 
self.module = module 


get(self, name): 


where = ' AND 1=1 ' 
if self.module: 

where += ''' AND module='%s' ''' % self.module 
sql = '''SELECT value FROM test_ data 


WHERE test_ case='%s! 
AND name='%s! 
AND status='active' %s;''' % (self.test_case, name, where) 


data = self.select data(sql) 
if data: 
return data[0] 
else: 
raise NOTESTDATAERROR (self.module, self.test case, name) 


select datal(self, sql): 
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db = MySQLdb.connect ("localhost", "root", "root", "datapool" ) ## 数 据 库 连接 


cursor = db.cursor() ## 获取 游标 
cursor.execute (sql) ## 执行 sql 语句 

data = cursor.fetchone() ## 获取 一 条 查询 结果 数据 
db.close() 


return data 


该 代码 清单 相 比 于 代码 清单 8-4，select_data 方法 由 原来 的 @staticmethod 改 成 了 实例 方 


法 ， 主 要 是 为 了 支持 对 测试 数据 按 模块 、 用 例 来 进行 分 类 的 需要 。 新 增 了 一 个 get 方 法 
获取 具体 的 测试 数据 ，get 方法 接受 一 个 数据 名 的 参数 并 返回 当前 用 例 下 对 应 数据 名 的 值 。 如 

果 查 找 的 数据 名 没有 记录 ， 则 抛 出 NOTESTDATAERROR 错误 ， 该 错误 会 在 用 例 层 被 捕获 并 
记录 。 关 于 NOTESTDATAERROR 将 会 在 8.6 节 中 进行 详细 介绍 。 


6. 测试 数据 层 的 引入 与 使 用 
在 完成 了 所 有 的 前 提 准 备 之 后 ， 就 可 以 在 用 例 层 来 调用 新 封装 的 DataPool 类 了 。 具 体 的 


用 例 层 调用 方式 如 下 。 


from DataPool import DataPool 


日 于 
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dp = DataPool ('demo') 
dp.get ('BAIDU HOME URL') 


如 果 之 前 使 用 的 是 文件 存储 方式 来 分 离 数据 ， 那 么 现在 只 需 简单 地 修改 代码 清单 8-2 的 
内 容 即 可 替换 为 数据 库存 储 方式 。 更 新 后 的 代码 见 代 码 清单 8-6。 


代码 清单 8-6 ”数据 库 分 离 测 试 数据 


#!/usr/bin/env python 

# -*- coding: utf-8 -*- 

from selenium import webdriver 

from selenium.webdriver.common.alert import Alert 
from time import sleep 

from DataPool import DataPool 


dp = DataPool ('demo') 
wd = webdriver.Chrome () 
wd.get (dp.get ('BAIDU_HOME URL')) 


wd.find_element by_id('kw').send keys (dp.get('SELENIUM')) 
wd.find_element by_id('su').click() 

sleep (1) 

assert dp.get('SELENIUM') in wd.title 

wd.close () 


该 代码 清单 中 唯一 的 一 处 代码 更 新 见 粗 体 标识 。 与 之 前 的 DataPool 类 使 用 相 比 ， 唯 一 的 
区 别 是 多 了 一 步 实例 化 的 操作 。 原 因 是 我 们 增加 了 对 测试 数据 进行 分 类 管理 的 功能 ， 在 实例 
化 的 时 候 需 要 传人 当前 TestCase 的 名 称 ， 例 如 demo。 这 样 在 获取 具体 测试 数据 的 时 候 则 只 
会 在 demo 用 例 的 测试 数据 中 查询 。 而 模块 名 在 不 传人 的 情况 下 则 默认 为 空 。 

总 的 来 讲 ， 关 于 测试 数据 管理 这 一 块 我 们 既 可 以 使 用 最 简单 的 文本 方式 来 存储 ， 也 可 以 
使 用 数据 库 来 存储 ; 不 同 的 方式 对 测试 数据 的 管理 支持 不 同 ， 文 本 的 方式 更 加 简洁 ， 更 容易 
变通 ， 但 是 不 利于 统一 管理 ; 数据 库 的 方式 可 以 更 加 集中 地 来 管理 测试 数据 ， 保 证 测试 数据 
的 统一 性 ， 但 是 需要 更 多 的 基础 支持 和 环境 管理 。 

在 实际 的 测试 项 目 中 ， 则 可 以 根据 自己 项 目的 需求 来 确定 使 用 什么 方式 来 管理 和 存储 测 
试 数据 。 其 中 可 以 参考 的 准则 例如 ， 哪 种 方式 更 方便 去 维护 测试 数据 ， 哪 种 方式 更 容易 生成 
测试 数据 ， 哪 种 方式 最 高 效 等 。 


8.2 ”定位 符 驱 动 层 


定位 符 指 的 是 用 于 定位 Web 页 面 上 特定 元 素 的 字符 串 。 在 第 2 章 中 已 经 学 习 了 如 何 定位 
并 操作 Web 元 素 。Selenium 中 支持 元 素 定位 的 方式 有 很 多 种 ， 本 书 中 推荐 使 用 CSS 定位 方 
式 。 理 由 是 使 用 同一 种 定位 方式 更 加 便于 统一 管理 。 另 外 ，CSS 定位 方式 可 以 支持 定位 任何 
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类 型 、 任 何 位 置 的 Web 元 素 。 而 本 章 主 要 介绍 的 内 容 是 如 何 把 用 例 脚 本 中 的 定位 符 数据 提取 
出 来 ， 作 为 独立 的 定位 符 驱动 层 。 
定位 符 驱 动 层 与 8.1 节 的 测试 数据 驱动 层 形式 基本 相同 ， 只 是 所 要 提取 的 数据 内 容 不 相 
同 。 定 位 符 驱 动 层 的 主要 作用 是 把 定位 符 内 容 与 具体 的 代码 进行 分 离 。 当 某 个 页 面 元 素 的 定 
位 符 需 要 更 新 的 时 候 ， 只 需要 更 新 定位 符 层 的 内 容 即 可 ， 而 不 需要 修改 任何 代码 。 
同样 地 ， 我 们 的 定位 符 层 也 可 以 有 两 种 方式 来 存储 : 一 种 是 本 地 文本 存储 ， 另 一 种 是 远 
程 服务 存储 方式 。 


8.2.1 本 地 文件 存储 


定位 符 的 本 地 文件 存储 方式 也 是 有 很 多 可 选 的 ， 除 了 Python 文件 之 外 ， 还 有 像 TXT、 
CSV、XML、JSON 等 格式 可 以 选择 。 为 了 让 本 地 文件 存储 可 以 有 多 一 种 的 可 选 方式 ， 本 节 
以 CSV 文件 存储 的 形式 来 介绍 定位 符 层 的 提取 与 使 用 。 

CSV (Comma-Separated Values) 文件 ， 即 俗称 的 逗号 分 隔 符 文件 。 默 认 的 CSV 文件 的 
每 一 行内 容 都 是 以 逗号 来 进行 分 割 的 ， 分 割 的 每 一 个 小 部 分 可 以 称 之 为 列 。 这 样 就 可 以 把 一 
个 文本 文件 当 作 一 个 二 维 表格 来 使 用 ， 并 在 文件 内 进行 数据 的 分 行 分 列 管理 。 

首先 ， 基 于 代码 清单 8-6 的 demo 代码 ， 可 以 分 析出 需要 提取 定位 符 数据 的 代码 只 有 如 
下 两 行 。 

wd.find element_by_id('kw').send_keys (dp.get('SELENIUM')) 

wd.find_element by_id('su').click() 


其 中 ，'kw' 'su' 则 是 需要 提取 的 定位 符 数 据 。 如 果 选 择 使 用 CSV 文件 来 存储 的 话 ， 那 么 
其 文件 内 容 形式 应 该 类 似 下 面 的 代码 。 


KEY_WORLDS, #kw 
SEARCH, #su 


可 以 看 出 每 一 行 只 描述 了 一 个 定位 符 ; 第 一 列 为 定位 符 的 名 字 ， 第 二 列 为 定位 符 的 具体 
的 值 。 如 果 使 用 该 CSV 文件 来 存储 定位 符 数据 ， 则 需要 再 做 点 儿 额 外 工作 来 读 取 CSV 文件 
的 数据 ， 否 则 ， 在 用 例 层 就 无 法 直接 获取 到 定位 符 数据 。 

关于 CSV 文件 的 读 取 ， 可 以 有 很 多 种 方式 ， 在 这 里 选择 使 用 Python 的 csv 类 库 来 进行 
读 取 。 假 设 把 csv 文件 读 取 代码 保存 在 Locatorpy 文件 中 ,具体 的 代码 内 容 如 下 。 

#!/usr/bin/python 


# -*- coding: UTF-8 -*- 
import csv 


def read csv(fn): 
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单 


csv file = file(fn, 'rb') 
reader = csv.reader(csv file) 
世 到 条 
for line in reader: 
if not line: 
continue 
if lenl(line)<2: 
d[line[0]] = "" 
else: 
d[line[0]] = line[1] 
csv file.close() 
Feturn d 


代码 中 read_csv 函数 接受 一 个 CSV 文件 路 径 作 为 参数 ， 并 读 取 CSV 文件 的 内 容 ， 最 后 
回 一 个 包装 好 定位 符 的 字典 对 象 。 在 用 例 层 引入 和 使 用 CSV 的 定位 符 代码 的 方式 如 下 。 


from Locator import read csv 


Locator = read csv('${path of _csv file}') 
Locator.get ('kw') 


这 里 假设 Locatorpy 文件 与 测试 用 例 脚本 文件 已 经 存放 在 同一 个 目录 下 ， 则 针对 代码 清 
8-6， 把 定位 符 数据 提取 出 来 之 后 ， 其 代码 内 容 更 新 如 代码 清单 8-7 所 示 。 


代码 清单 8-7 ”定位 符 本 地 存储 分 离 


#!/usr/bin/env python 

人 

from selenium import webdriver 

from selenium.webdriver.common.alert import Alert 
from time import sleep 

from DataPool import DataPool 

from Locator import read_csV 


locator = read csv('${path of _ csv file}') 
dp = DataPool ('demo') 

wd = webdriver.Chrome () 

wd.get (dp.get ('BAIDU HOME URL')) 


wd.find element by id(locator.get('KEY WORLDS')) .send keys (dp.get('SELENIUM')) 
wd.find element by id(locator.get('SEARCH')) .click() 

sleep (1) 

assert dp.get('SELENIUM') in wd.title 

wd.close() 


上 述 代码 中 修改 的 部 分 为 加 粗 字体 ， 通 过 上 述 修改 之 后 测试 用 例 代 码 中 的 定位 符 数据 就 


被 提取 到 定位 符 层 了 。 
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8.2.2 ”远程 服务 存储 


远程 存储 是 相对 于 本 地 存储 方式 而 言 ， 它 可 以 在 不 同 机 器 间 进 行 共享 。8.1 节 中 的 数据 
库存 储 方式 就 是 远程 存储 方式 的 一 种 ， 除 此 之 外 ， 还 可 以 使 用 Web Service 的 方式 来 提供 远 
程 存储 服务 。 而 本 节 将 继续 以 数据 库存 储 的 方式 来 讲解 定位 符 的 远程 存储 。 

数据 库存 储 的 基础 环境 安装 在 8.1.2 节 已 经 介绍 过 了 ， 这 里 补充 说 明 下 如 果 需 要 MySQL 
数据 库 支持 远程 访问 ， 还 需要 进行 如 下 两 个 步骤 的 设置 。 

口 修改 msqlini 配置 文件 。 

口 修 改 非 本 机 访问 的 I 了 P 限制 。 

首先 要 找到 mysql.ini 文件 ， 不 同系 统 和 MySQL 版 本 该 文件 存放 位 置 有 所 区 别 。 然 后 搜 
索 bind-address 关键 字 ， 并 在 下 面 这 行 前 面 添加 # 来 注释 掉 ， 然 后 重启 MySQL 服务 。 

bind-address = 127.0.0.1 

接着 ， 使 用 root 账户 进入 MySQL， 并 切换 到 MySQL 库 。 然 后 进行 全 访问 限制 的 修 
改 ， 具 体 的 操作 代码 如 下 所 示 。 

mysql -u root -pyoupassword 

mysql>use mysql; 

mysql>update user set host = '$%' where user ='root' and host='127.0.0.1'; 


mysql>select host, user from user; 
mysql>flush privileges; 


经 过 上 面 两 个 步 又 的 操作 之 后 ， 我 们 的 MySQL 数据 库 就 可 以 支持 使 用 root 账户 在 任意 
的 可 访问 的 网 络 机 器 上 登录 了 。 

最 后 需要 考虑 的 是 定位 符 表 的 结构 设计 ， 如 果 没有 特殊 需求 的 话 ， 该 表 的 结构 与 测试 数 
据 表 的 结构 基本 一 致 。 内 容 如 下 所 示 。 


CREATE TABLE ‘locator. ( 
“id int(11) NOT NULL AUTO_INCREMENT, 
“module”varchar (255) DEFAULT NULL COMMENT ' 模块 名 '， 
“page”varchar (255) NOT NULL COMMENT ' 测试 页 名 称 '， 
“name ”varchar (255) NOT NULL COMMENT ' 测试 数据 名 '， 
“value”varchar (255) NOT NULL COMMENT ' 测试 数据 的 值 '， 
“desc”varchar (255) DEFAULT NULL COMMENT ' 测试 数据 的 描述 '， 
“status、 enum('active', 'inactive') DEFAULT 'active' COMMENT ' 数据 是 否 有 效 '， 
“createAt ”date DEFAULT NULL COMMENT ' 创建 日 期 '， 
PRIMARY KEY (“id), 
UNIQUE KEY ‘page name. (‘page', ‘name) 

) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8; 


由 于 在 8.1.2 节 中 读 取 数据 库 的 方式 不 够 优化 ， 每 一 次 获取 测试 数据 都 需要 重新 连接 数 
据 库 。 为 了 让 数据 库 读 取 能 够 有 更 好 的 性 能 ， 这 里 对 数据 库 读 取代 码 进行 了 优化 。 假 设 新 代 
码 保存 在 DBLocatorpy 文件 中 ， 改 进 后 的 数据 库 读 取代 码 如 下 。 
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#!/usr/bin/env Python 
关 ~-*- coding: utf-8 -*- 


import MySQLdb 
from ExceptionWarpper import NOLOCATORERROR 


class Locator (object): 
def _ init (self, page, module=None): 
self.page = page 
self.module = module 
sql = self. get sql _() 
self.data = self.select datal(sql) 


def get (self, name): 
value = self.data.get (name) 
if value: 
return value 
else: 
raise NOLOCATORERROR (self.module, self.page, name) 


def _ get sql__(self): 


where = "' AND 1=1 ' 
if self.module: 
where += ''' AND module='%s' ''' % self.module 
sql = '''SELECT name, value FROM locator 
WHERE page="'%s’' 
AND status='active' %s;''' % (self.page, where 


return sql 


def select datal(self, sql): 
db = MySQLdb .connect ("localhost", "root", "root", "datapool" ) ## 数 据 库 连接 


cursor = db.cursor() ## 获取 游标 
cursor.execute (sql) ### 执行 SQL 语句 
data = cursor.fetchall () ## 获取 所 有 查询 结果 数据 
db.close() 
if data: 

return dict (data) 
else: 


raise NOLOCATORERROR (self.module, self.page, None) 


上 述 代 码 中 相对 于 8.1.2 节 的 代码 ， 重 点 优化 部 分 为 加 粗 字 体 。 新 增 了 一 个 内 部 方法 
_get_sql “专门 用 来 拼接 SQL 查询 ， 并 在 初始 化 的 时 候 即 调用 。 初 始 化 方法 中 还 调用 了 
select_data 方法 ， 直 接 获取 指定 页 面 上 的 所 有 locator 定位 符 数据 并 保存 在 data 属性 中 。 之 后 
的 所 有 get 方法 都 是 在 self data 属性 中 获取 ， 而 不 再 需要 重新 连接 数据 库 。 

在 用 例 层 代码 中 想 要 引入 和 使 用 该 模块 的 方式 如 下 。 


from DBLocator import Locator 
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locator = Locator('${test_case name}') 


locat 


or.get ('KEY _ WORLDS') 


针对 代码 清单 8-7 进行 更 新 后 的 完整 代码 如 代码 清单 8-8 所 示 。 


#!/us 
闫 2= 
from 
from 
from 
from 
from 


代码 清单 8-8 ”定位 符 本 地 存储 分 离 优 化 


r/bin/env python 

coding: utf-8 -*- 

selenium import webdriver 
selenium.webdriver.common.alert import Alert 
time import sleep 

DataPool import DataPool 

DBLocator import Locator 


locator = Locator ('demo') 


dp = 
wd = 


DataPool ('demo') 
webdriver.Chrome () 


wd.get (dp.get ('BAIDU_ HOME URL')) 


wd.find element by_id(locator.get('KEY WORLDS')).send keys (dp.get('SELENIUM')) 
wd.find element by_id(locator.get('SEARCH')).click() 

sleep (1) 

assert dp.get('SELENIUM') in wd.title 


wd.cl 


ose () 


上 述 代码 中 更 新 内 容 为 加 粗 字 体 ， 可 以 看 到 我 们 只 对 引入 和 实例 化 进行 了 修改 ， 而 在 数 
据 获取 的 接口 上 与 原来 保持 一 致 ， 以 尽量 减少 对 既 有 代码 的 改动 。 


注意 
得 代码 更 


如 果 是 从 原来 的 CSV 文 件 存储 方式 ， 修 改 为 使 用 数据 库存 储 的 方式 ， 记 
新 完成 后 ， 还 需要 在 数据 库 中 添加 CSV 文 件 中 对 应 的 数据 ， 否 则 会 抛 出 


NOLOCATORERROR 异常 。 


8.3 页 面 操作 层 
页 面 操作 层 是 专门 用 于 封装 页 面 元 素 操作 的 。 每 一 个 页 面 都 需要 有 一 个 对 应 的 操作 类 ， 


在 这 个 类 是 


且 面 包含 该 页 面 上 所 有 的 测试 场景 所 需要 的 用 户 操作 。 在 上 层 的 业务 层 或 者 用 例 层 


中 可 以 直接 引入 该 类 并 调用 其 对 应 的 元 素 操作 方法 ， 而 无 须 再 关心 定位 符 及 具体 的 元 素 操作 


流程 。 


接 下 来 就 以 代码 清单 8-8 为 基础 ， 来 提取 页 面 层 的 操作 代码 。 首 先 ， 从 代码 清单 8-8 中 


可 以 看 出 


其 页 面 操作 主要 有 三 个 ,分别 为 进入 百度 首页 、 在 百度 首页 输入 框 中 输入 内 容 、 单 


击 百度 首页 的 搜索 按钮 。 经 过 简单 的 提取 把 百度 首页 的 三 个 操作 存放 在 独立 的 BaiduHome.py 
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文件 中 。 其 具体 的 代码 如 代码 清单 8-9 所 示 。 


代码 清单 8-9 ”页 面 层 分 离 


#!/usr/bin/env Python 
# -*-— coding: utf-8 —*~ 
from DBLocator import Locator 


class BaiduHome (Object): 
def _init_ (self, wd): 
self.wd = wd 
self.locator = Locator('demo') 


def gotol(self, url): 
self.wd.get (url) 


def input keywords (self, key words): 
self.wd.find element by_ idl(\ 
self.locator.get ('KEY WORLDS'))\ 
.Send_ keys (key words) 


def click search btn(self) : 
self.wd.find element by id(\ 
self.locator.get('SEARCH')) .click() 


上 述 代码 中 ,已 经 把 跟 百 度 首页 有 关 的 操作 都 提取 到 了 独立 的 Python 文件 中 ， 并 且 封 
装 在 名 为 BaiduHome 的 类 中 。 类 中 除了 初始 化 方法 之 外 ， 还 为 每 个 具体 操作 单独 定义 了 一 个 
对 应 的 方法 。goto 方法 用 于 跳 转 到 百度 首页 ，input_keywords 方法 用 于 在 百度 首页 输入 框 中 
进行 输入 ，click_search_btn 方法 用 于 单 击 百度 首页 的 搜索 按钮 。 

另外 ， 从 代码 清单 8-9 中 还 可 以 发 现 ， 只 能 对 Locator 进行 引用 和 初始 化 ， 而 并 未 对 
DataPool 进行 引用 。 这 是 因为 Locator 与 具体 的 页 面 是 绑 定 ， 而 测试 数据 则 与 具体 的 测试 场 
景 相 关 ， 它 应 该 在 用 例 层 进行 引用 。 

在 对 页 面 操作 代码 进行 提取 之 后 ， 代 码 清单 8-8 的 内 容 应 该 修改 成 如 代码 清单 8-10 所 示 
的 内 容 。 


代码 清单 8-10 ”提取 页 面 操作 层 


#!/usr/bin/env python 

ey Oding Utf-8 ~ 

from selenium import webdriver 

from selenium.webdriver.common.alert import Alert 
from time import sleep 

from DataPool import DataPool 

from BaiduHome import BaiduHome 


dp = DataPool ('demo') 
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wd = webdriver.Chrome () 


bdh = BaiduHome (wd) 

bdh.goto (dp.get ('BAIDU HOME URL') 
bdh.input _ keywords (dp.get ('SELENIUM')) 
bdh.click search btn() 


sleep (1) 
assert dp.get('SELENIUM') in wd.title 
wd.close () 


经 过 上 述 提取 操作 之 后 ， 就 已 经 得 到 了 一 个 页 面 操作 层 。 但 这 个 页 面 操作 层 仅 仅 是 把 页 
面 操作 内 容 提 取出 来 。 为 了 让 页 面 操作 层 能 更 加 统一 和 健壮 ， 还 需要 给 页 面 操作 层 增加 一 些 
封装 的 功能 。 例 如 ,检查 操 作 元 素 是 否 存在 ， 操 作 异 常 记录 、 复 杂 元 素 对 象 的 操作 等 。 由 于 
这 些 功 能 对 于 每 一 个 页 面 操作 都 是 需要 的 ， 为 此 可 以 定义 一 个 基础 的 页 面 操作 类 ， 而 其 他 实 
际 页 面 操作 类 都 会 继承 自 该 类 。 该 基础 页 面 类 可 以 是 如 代码 清单 8-11 所 示 的 内 容 ， 假 设 代码 
保存 在 PageBase.py 文件 中 。 


代码 清单 8-11 基础 页 面 操 作 类 


#!/usr/bin/env python 
# 0ding: Wt 一 “一 


from selenium.webdriver.support.select import Select 
from ExceptionWarpper import * 


class PageBase (object): 
def _init__(self, driver, locators): 
self.wd = driver 
self.locators = locators 


def _del__ (self): 
pass 


Qelement_not_found exception 
def get element (self, locator): 
return self.wd.find element by css_selector(self.locators.get (locator, '')) 


Qelement not_ found exception 
def get elements(self, locator): 
return self.wd.find elements by css_selector(self\ 
.locators.get (locator, '')) 


def select by index(self, locator, index): 
ele = self.get element (locator) 
if ele and ele.get attribute('tagName')=="'SELECT': 
options = ele\ 
.find elements_by_css_selector ('option') 
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if options and len(options)>=index+l: 
Select (ele) .select by index (index) 
else: 
print '‘'options is too less to select' 
else: 
print "element is not select object' 


def select by valuel(self, locator, value): 
ele = self.get element (locator) 
if ele and ele.get attribute('tagName')=="'SELECT': 
options = ele.find elements_by_css_selector ('option') 
if options : 
for option in options : 
new_value = option.get attribute('value') 
if value==new_value: 
Select (ele) .select by value (value) 
return 
print 'no value matched' 
else: 
print 'options is too less to select' 
else: 
print "element is not select object' 


def select by text(self, locator, text): 
ele = self.get element (locator) 
if ele and ele.get_attribute('tagName')=='SELECT' : 
options = ele.find elements by_css_selector('option') 
if options: 
for option in options: 
new text = option.get attribute('innerText') 


if text==new text: 
Select (ele) .select by visible text (text 
return 
print 'no text matched' 


else: 


print 'options is too less to select' 
else: 


print 'element is not select object' 


def check box(self, locator, on=True): 
ele = self.get element (locator) 
if ele and ele.get attribute('tagName')=='INPUT' and ele.get_ 
attribute('type')=='checkbox"': 
status = ele.is_selected() 
if status != on: 
ele-click() 
else: 
Print "element is not checkbox object' 


def radio box(self, locator, on=True): 
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ele = self.get element (locator) 
if ele and ele.get attribute('tagName')=='INPUT' and ele.get_ 
attribute('type')=='radio': 
status = ele.is_selected() 
if status != on: 
ele.click() 
else: 
print '‘'element is not checkbox object' 
def gotol(self, url): 
self.wd.get (url) 


上 面 的 基础 页 面 类 中 ， 封 装 了 一 些 基本 的 方法 ， 主 要 内 容 如 下 。 
口 对 查找 元 素 方法 的 封装 。 
口 对 select、checkbox 、rediobox 元 素 操作 的 封装 。 
口 对 异常 场景 的 处 理 封装 ， 如 : 装饰 器 @element_not found_exception。 
其 中 ， 装 饰 器 @element_not found_exception 用 来 处 理 和 记录 查找 元 素 失 败 时 的 场景 ， 
具体 的 函数 代码 在 后 面 将 会 讲 到 。 
有 了 代码 清单 8-11 中 的 代码 之 后 ， 在 具体 实现 某 个 页 面 操 作 类 时 ， 就 可 以 继承 该 基础 
类 ， 从 而 获得 相应 的 方法 。 而 代码 清单 8-9 就 可 以 修改 成 如 代码 清单 8-12 所 示 的 样子 。 


代码 清单 8-12 页 面 层 代 码 优化 


#!/usr/bin/env python 
odings tf -= 

from PageBase import PageBase 
from DBLocator import Locator 


class BaiduHome (PageBase): 
def _init (self, wd): 
PageBase. init__(self, wd, Locator('demo')) 


def input keywords (self, key words): 
self.get_element ('KEY_WORLDS')\ 
.Send keys (key_ words) 


def click_ search btn(self) : 
self.get element ('SEARCH') .click() 


在 代码 清单 8-12 中 继承 了 PageBase 类 ， 然 后 在 查找 页 面 元 素 时 直接 使 用 PageBase 类 中 
的 get_element 方法 。 需 要 注意 的 是 ，get_element 方法 仅 支持 CSS 定位 符 规则 。 

而 在 经 过 上 述 代 码 修改 之 后 ， 代 码 清单 8-10 中 的 用 例 层 代 码 却 不 需要 任何 的 改变 就 可 
以 直接 运行 。 这 就 是 提取 页 面 操作 层 的 好 处 ， 当 页 面 操作 代码 需要 调整 时 ， 某 些 时 候 并 不 需 
要 修改 用 例 层 代码 。 
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8.4 业务 逻辑 层 


所 谓 的 业务 就 是 常规 的 用 户 操作 ， 而 业务 层 就 是 针对 某 一 个 业务 流程 的 逻辑 层 。 通 常 一 
个 系统 中 各 个 业务 流程 之 间 都 有 一 些 相通 之 处 ， 这 些 相通 的 业务 部 分 都 是 可 以 被 我 们 进行 提 
取 的 。 在 具体 的 测试 用 例 开 发 之 前 先进 行 可 复 用 的 业务 代码 开发 ， 可 以 帮助 我 们 提高 业务 代 
码 的 复 用 率 和 用 例 开发 效率 ， 下 面 将 分 两 节 来 介绍 业务 逻辑 层 的 实现 。 


8.4.1 公共 业务 


公共 业务 指 的 是 那些 属于 基础 模块 的 业务 ， 这些 业务 是 上 层 业 务 的 基础 操作 或 者 前 提 ， 
并 且 会 被 多 个 上 层 业 务 所 调用 。 例 如 ， 登 录 模 块 ， 所 有 需要 身份 认证 的 其 他 模块 都 需要 调 
用 。 总 而 言 之 ， 就 是 可 以 被 多 次 复 用 的 基础 业务 。 接 下 来 就 以 登录 场景 为 例 来 介绍 下 业务 层 
的 封装 与 使 用 。 具 体 代 码 见 代码 清单 8-13 为 登录 页 的 操作 类 ， 代 码 清单 8-14 为 登录 业务 的 
封装 类 。 


代码 清单 8-13 ”登录 页 操作 封装 


#!/usr/bin/env python 
# -*- coding: utf-8 -*- 


from PageBase import PageBase 
from DBLocator import Locator 


class LoginPage (PageBase): 
def _ init__(self, wd): 


PageBase. init__(self, wd, Locator('demo')) 


def _del__(self): 
pass 


def input user name (self, value): 
self.get _ element ('USER NAME') .send keys (value) 


def input passwrod(self, value): 
self.get_ element ('PASSWORD') .send_ keys (value) 


def click login btn(self) : 
self.get element ('LOGIN') .click() 


代码 清单 8-14 ”登录 页 业务 封装 


#!/usr/bin/env python 
# -*- coding: utf-8 一 * 一 


from LoginPage import LoginPage 
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class LoginModule (object): 
def init (self, wd): 
self.page = LoginPage (wd) 


def del (self): 
pass 


def loginl(self, username, password): 
self.page.input user name (username) 
self.page.input passwrod (password) 
self.click login btn() 
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代码 清单 8-14 中 引入 了 LoginPage 类 ， 并 在 LoginModule 类 的 login 方法 中 封装 了 登录 
业务 的 具体 操作 。 在 用 例 层 的 代码 里 调用 login 方法 的 具体 方式 见 代 码 清单 8-15。 这 里 假设 


代码 清单 8-14 的 代码 保存 在 Business.py 文件 中 。 
代码 清单 8-15 “登录 页 方法 调用 


#!/usr/bin/env Python 

odings Er 一 “一 

from selenium import webdriver 

from selenium.webdriver.common.alert import Alert 
from time import sleep 

from DataPool import DataPool 

from Business import LoginModule 


dp = DataPool ('demo') 
wd = webdriver.Chrome () 
lm = LoginModule (wd) 


wd.goto(dp.get ('LOGIN_URL') 
1m.login(dp.get (‘USERNAME’), dp.get (‘PASSWORD’)) 


sleep (1) 
Alert dp.get('LOGIN SUCCESS TEXT') in wd.title 
wd.close() 


代码 中 重点 部 分 为 加 粗 字体 ， 主 要 为 LoginModule 业务 模块 的 引入 、 实 例 及 使 用 ， 其 他 


部 分 与 上 一 节 一 致 。 


8.4.2 ”常规 业务 
常规 业务 不 是 作为 其 他 模块 所 必需 的 前 提 业 务 , 但 也 是 可 以 对 其 进行 业务 提取 的 。 


因为 


除了 测试 正常 流程 之 外 ， 还 需要 对 非法 流程 进行 检查 。 即 使 对 于 单一 的 某 个 业务 流程 来 说 ， 


也 需要 反复 测试 很 多 遍 不 同 的 数据 和 操作 ， 对 于 这 类 业务 场景 也 是 可 以 提取 到 业务 层 的 。 


假设 有 一 个 被 测试 的 页 面 需要 经 N 步 操作 才能 到 达 ， 这 样 对 于 该 页 面 上 的 所 有 用 例 来 
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说 ， 到 达 该 页 面 之 前 的 业务 流程 即 为 可 以 被 提取 的 常规 业务 流程 。 常 规 业 务 的 封装 、 使 用 方 
法 与 公共 业务 的 方式 一 致 ， 在 这 里 需要 补充 说 明 下 如 何在 用 例 层 同时 引入 并 使 用 页 面 层 和 业 


务 层 的 方法 。 


首先 基于 8.2.1 节 的 代码 清单 场景 ， 已 经 引入 并 使 用 LoginModule 类 ， 接 着 需要 


由 


导 | 关 


一 个 登录 成 功 后 的 页 面 操作 类 ， 在 这 个 页 面 只 做 一 件 事 ， 即 获取 用 户 的 登录 名 。 页 面 操作 类 


的 具体 代码 见 代 码 清单 8-16。 
代码 清单 8-16 ”登录 成 功 页 操作 


#!/usr/bin/env python 
#4 =*= coding: utf=8 -*- 


from PageBase import PageBase 
from DBLocator import Locator 


class DashBoard (PageBase): 
def _ init (self, wd): 
PageBase. init__(self, wd, Locator('demo')) 


def del (self): 
pass 


def get user name (self): 
return self.get element('USER DISPALY NAME')\ 
-get attribute('innerText') 


接 下 来 要 在 用 例 层 的 代码 中 引入 并 使 用 该 页 面 类 的 方法 ， 具 体 如 代码 清单 8-17 所 示 。 


代码 清单 8-17 ”用例 层 代码 调用 登录 页 


#!/usr/bin/env python 

i opding: Ltf-B 一 上 一 

from selenium import webdriver 

from selenium.webdriver.common.alert import Alert 
from time import sleep 

from DataPool import DataPool 

from Business import LoginModule 

from Dashboard import DashBoard 


dp = DataPool ('demo') 
wd = webdriver.Chrome () 
lm = LoginModule (wd) 
db = DashBoard (wd) 


wd.goto(dp.get ('LOGIN_URL') 
lm.login(dp.get('USERNAME'), dp.get('PASSWORD')) 
user name = db.get user name() 
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sleep(1) 
Alert dp.get('USER DISPLAY NAME') == user name 
wd.close () 


代码 中 粗 体 部 分 为 关键 变化 内 容 。 即 在 引入 的 时 候 把 需要 的 页 面 类 、 业 务 类 都 引入 ; 在 
初始 化 的 时 候 把 两 个 类 都 进行 实例 化 ; 最 后 在 使 用 时 通过 赋值 变量 调用 对 应 的 封装 方法 即 可 。 


8.5 ”结果 驱动 层 


结果 驱动 层 主要 是 用 来 记录 测试 结果 及 过 程 日 志 的 。 除 了 可 以 记录 通过 和 失败 的 用 例 信 
息 ， 还 可 以 记录 测试 过 程 中 的 上 下 文 信息 。 例 如 ， 蜡 常 信息 、 测 试用 例 信息 等 。 而 在 记录 日 
志方 面 最 容易 想到 的 就 是 Python 自 带 的 日 志 库 ， 可 以 很 方便 地 记录 各 种 等 级 的 日 志 信息 。 此 
外 还 可 以 自 定义 一 个 日 志 类 ， 专 门 用 于 记录 测试 结果 所 用 。 本 章 就 来 学 习 这 两 种 日 志 的 记录 
方式 。 


8.5.1 日 志 Logger 记录 


Python 中 记录 日 志 所 用 的 模块 是 logging， 其 为 内 置 模块 ， 无 须 安装 即 可 直接 使 用 。 简 
单 的 使 用 方式 如 下 。 

import logging 

1ogging.critical("The critical message") 

##output => WARNING:root:The critical message 

logging.error ("The error message") 

##OutPut => WARNING:root:The error message 

logging.warning ("The warning message") 

##o0utput => WARNING:root:The warning message 

logging.info("The info message") 

##output => 

logging.debug ("The debug message") 

##output => 


从 代码 中 可 以 看 出 ，logging 模块 可 以 为 日 志 的 输出 提供 多 种 日 志 等 级 ， 从 高 到 低 依次 
为 critical > error > warning > info > debug。 只 有 当 我 们 日 志 记录 语句 的 等 级 高 于 或 等 于 所 设 
置 的 日 志 等 级 时 ， 该 条 日 志 记录 语句 才能 被 输出 。 默 认 的 logging 模块 日 志 等 级 为 warning， 
所 以 在 代码 中 只 有 warning、error、critical 的 信息 被 打印 出 来 ， 而 低 于 warming 等 级 的 info、 
debug 信息 则 没有 被 打印 。 

另外 ， 上 面 的 代码 会 把 日 志 内 容 直 接 打印 在 控制 台 ， 而 如 果 我 们 希望 能 够 把 日 志 信息 
以 固定 的 格式 来 记录 到 指定 的 日 志文 件 里 ， 则 需要 在 使 用 之 前 对 logging 模块 进行 一 些 设置 。 
例如 ， 代 码 清单 8-18 就 对 日 志 等 级 、 日 志文 件 、 日 志 格 式 进 行 了 设置 。 
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代码 清单 8-18 “日志 格式 设置 


#!/usr/bin/python 
# -*- coding: UTF-8 -*- 
import logging 


logging.basicConfig (level=logging .DEBUG, 
format='s(asctime)s %(filename)s[line:%(lineno)d] %(levelname)s %(message)s', 
datefmt='%a, %d %b %Y %H:%M:%S', 
filename='test.1o0g', 
filemode='w') 


logging.debug('The debug message') 
logging.infol('The info message') 
logging.warning('The warning message') 


上 述 代码 中 通过 logging 模块 的 basicConfig 方法 来 进行 日 志 的 基本 设置 。level 参数 用 于 
设置 日 志 等 级 ; format 参数 用 来 设置 日 志 的 输出 格式 及 内 容 ; datefmt 参数 用 来 设置 日 期 的 输 
出 格式 ;filename 参数 用 来 指定 日 志文 件 的 位 置 ; filemode 参数 用 来 设置 日 志 的 写 人 模式 ，w 
为 覆盖 写 人 ，a 为 追加 写 入 。 代 码 清单 8-18 输出 的 结果 如 下 。 


2016-12-12 21:33:52 uTest3.py[line:11] DEBUG The debug message 
2016-12-12 21:33:52 uTest3.py[line:12] INFO The info message 
2016-12-12 21:33:52 uTest3.py[line:13] WARNING The warning message 


根据 结果 对 照 代码 清单 8-18 所 示 的 format 格 式 串 ， 可 以 知道 format 格 式 串 中 的 
%(asctime)s 是 一 个 当前 时 间 的 占 位 符 ，%(filename)s 是 打印 日 志 语 句 所 在 文件 名 ，%(lineno)d 
是 打印 日 志 语 句 所 在 的 行 数 ，%(levelname)s 是 当前 日 志 的 等 级 ，%(message)s 才 是 我 们 真正 
所 记录 的 日 志 信 息 。 除 此 之 外 ，format 格式 串 还 有 其 他 的 一 些 占 位 符 可 以 选择 ， 感 兴趣 的 读 
者 可 以 再 进一步 研究 下 ， 会 有 更 多 的 收获 。 

接 下 来 看 看 logging 模块 在 记录 测试 日 志 、 结 果 时 应 该 如 何 设置 才能 发 挥 它 最 好 的 效果 。 
由 于 我 们 同时 需要 记录 测试 日 志 信息 和 测试 结果 ， 所 以 最 好 把 这 两 个 信息 存放 在 不 同 的 文件 
里 便于 分 析 和 统计 ;而且 同时 我 们 也 希望 脚本 在 执行 的 时 候 能 有 日 志 在 控制 台 输 出 ， 方 便 及 
时 查看 运行 状态 。 

为 此 需要 使 用 logging 模块 所 支持 的 多 日 志 记录 功能 来 达到 效果 。 其 使 用 方式 可 以 通过 
配置 logging 的 配置 文件 来 很 方便 地 实现 ， 具 体 来 看 下 已 经 配置 好 的 logging 配置 文件 示例 。 
这 里 假定 内 容 保存 在 名 为 logger.conf 的 文件 中 。 


#1ogger .Conf 

覃 大 排 大 提 拓 大 提 拓 提 捍 提 捍 捍 提 提 非 扩大 提 拓 提 扒 捍 捍 提 提 提 提 提 大 提 提 提 提 提 捍 提 提 提 提 提 提 提 提 提 # 
[loggers] 

keys=root, result, infomation 

[logger root] 
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level=DEBUG 

handlers=infohander, resulthander 

[logger result] 

level=CRITICAL 

handlers=resulthander,consolehander 

qualname=result 

propagate=0 

[logger infomation] 

level=DEBUG 

handlers=infohander, consolehander 

qualname=infomation 

propagate=0 

非 拓 拓 大 大 大 大 大 扩 提 拓 大 振 振 振 拓 大 拓 提 提 拓 大 拓 拓 拓 拓 拓 振 持 提 提 提 提 提 提 拓 拓 拓 拓 失 闪失 并 提 提 间 夫 

[handlers] 

keys=resulthander, infohander, consolehander 

[handler resulthander 

class=FileHandler 

formatter=form01 

args=('testresult.log', 'w') 

[handler_infohander] 

class=FileHandler 

formatter=form02 

args=('testinfo.log', ‘'w') 

[handler consolehander] 

class=StreamHandler 

formatter=form02 

args=(sys.stderr,) 

拓 排 拓 拓 大 扩大 扩 扩 夺 大 大 振 振 振 拓 大 拓 拓 拓 拓 拓 拓 拓 持 持 持 振 振 拓 拓 提 提 拓 直 直 拓 振 持 持 闪失 振 拓 提 提 # 

[formatters] 

keys=form01, form02 

[formatter_form01] 

format=% (message)s::%(filename)s.%(funcName)s 

datefmt=%Y-%m-%d %H:%M:%S 

[formatter form02] 

format=% (asctime)s %(filename)s.%(funcName)s[line:%(lineno)d] %(levelname)s 
S$(message)s 

datefmt=%Y-%m-%d %H:%M:%S 


该 配置 文件 配置 了 两 个 自 定义 的 logger 一 一 result 和 information 分 别 用 来 记录 测试 结果 
和 日 志 信 息 。 配 置 了 resulthander、infohander 和 consolehander 共 三 个 hander， 分 别 用 来 记录 
到 结果 文件 、 日 志文 件 和 输出 到 控制 台 。 而 且 给 结果 日 志和 信息 日 志 分 别 定 义 了 不 同 的 日 志 
格式 。logging 模块 加 载 和 使 用 该 配置 文件 如 代码 清单 8-19 所 示 。 


代码 清单 8-19 “日 志 模块 加 载 


#!/usr/bin/python 

才 = woding* UTF-A =*= 
import logging 

import logging.config 
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logging.config.fileConfig ("logger.conf") 
resulter = logging.getLogger ("result") 
infor = logging.getLogger ("infomation") 


resulter.critical ('PASS') 
resulter.critical ('FAIL') 


infor.debug ("The debug message") 
infor.info('The info message') 
infor.warning('The warning message') 


代码 中 粗 体 标示 的 代码 为 使 用 配置 文件 的 关键 代码 ; 通过 logging 的 fileConfig 方法 来 加 
载 配 置 文件 ， 并 通过 logger 的 名 称 来 获取 对 应 的 logger， 之 后 就 可 以 通过 获取 的 logger 记录 
结果 和 日 志 了 。 


提示 logging.getLogger("result") 中 的 result 并 不 是 配置 文件 中 的 [logger] 下 的 result， 
而 是 qualname 的 值 为 result 的 logger， 由 于 我 们 配置 时 使 用 的 都 是 result， 所 以 没有 很 明显 
的 区 别 。 


使 用 代码 打印 出 来 的 输出 有 三 处 : 第 一 处 是 控制 台 ; 第 二 处 是 结果 文件 testresult.log ; 
第 三 处 是 信息 日 志 testinfo.log。 三 处 打印 的 内 容 如 图 8-2 所 示 。 


:10] CRITICAL PASS 

:11] CRITICAL FAIL 

:13] DEBUG The debug message 
ne:14] INFO The info message 


016-12-18 10:47:31 Result. py- 
console 


[line:15] WARNING The warning message 


ASS: :Result. py. <nodule> 


AIL: :Result. py. <module> 
lestresult.Jog 


016-12-18 10:47:31 Result. py. ‘module> [line:13] DEBUG The debug message 
016-12-18 10:47:31 Result. py. <module’ [line:14] INFO The info message 


016-12-18 10:47:31 Result. py. ‘module> [line:15] WARNING The warning message 
estinfo.log 


图 8-2 测试 日 志 结 果 


到 目前 为 止 ， 我 们 已 经 学 习 了 Python 的 logging 模块 的 基本 使 用 和 定制 化 的 配置 。 还 需 
要 把 配置 好 的 日 志 模块 加 入 到 前 面 的 自动 化 框架 中 ， 完 成 整个 测试 框架 的 集成 工作 。 简 单 来 
说 ， 就 是 把 之 前 使 用 print 打印 的 代码 ， 替 换 为 使 用 logger 来 进行 记录 。 这 样 就 可 以 直接 把 
测试 代码 中 的 所 有 信息 都 很 方便 地 记录 到 不 同 的 日 志文 件 中 。 

最 后 ， 再 来 看 看 如 何 把 日 志 记录 的 功能 添加 到 测试 框架 中 。 首 先 需要 把 日 志 记 录 功 能 进 
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假定 


行 简单 的 封装 ， 对 外 部 提供 一 个 统一 的 调用 接口 ， 便 于 框架 中 的 各 模块 进行 调用 。 这 号 
封装 后 的 结果 记录 文件 名 为 Resultpy， 则 其 代码 如 代码 清单 8-20 所 示 。 


代码 清单 8-20 “日 志 封 装 模 块 


#!/usr/bin/python 
~-*~ Coding: UTF-8 -*- 
import logging 
import logging.config 
import sys,os 
def findcaller (func): 
def wrapper (*args) : 
f=sys._getframe() 
filename=f.f back.f_code.co filename 
funcname=f.f back.f_ code.co name 
lineno=f.f back.f_ lineno 
args = list (args) 
args.append('%s.%s.%s' % (os.path.basename (filename), 
funcname, lineno)) 
func (*args) 
return wrapper 


class Result (object): 
def _init (self): 
logging.config.fileConfig ("logger.conf") 
self.resulter = logging.getLogger ("result") 
self.infor = logging.getLogger ("infomation") 


@findcaller 
def log pass(self, caller="''): 
self.resulter.critical('PASS::'+tcaller) 


@findcaller 
def log faill(self, caller="''): 
self.resulter.critical ('FAIL::'+caller) 


@findcaller 
def log debug(self, msg, caller=''): 
self.infor.debug('[%s] %s' % (caller, msg)) 


@findcaller 
def log info(self, msg, caller="''): 
self.infor.info('[%s] %s' gs (caller, msg)) 


@findcaller 
def log warning(self, msg, caller="''): 
self.infor.warning('[%s] %s' % (caller, msg)) 


@findcaller 
def log errorl(self, msg, caller="''): 
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self.infor.error('[%s] %s' % (caller, msg)) 


@findcaller 
def log criticall(self, msg, caller="''): 
self.infor.critical('[%s] %s' % (caller, msg)) 


代码 解析 代码 中 定义 了 一 个 Result 类 和 一 个 fndcaller 的 装饰 器 。Result 类 就 是 我 们 
在 测试 框架 中 需要 调用 的 日 志 类 ; 而 findcaller 装饰 器 主要 用 来 获取 调用 日 志 代 码 所 在 的 函数 


文件 名 、 行 数 等 信息 。 


有 了 上 面 封装 好 的 Result 类 ， 在 测试 框架 中 直接 引入 、 实 例 之 后 就 可 以 使 用 ,具体 的 代 


码 调 用 示例 如 代码 清单 8-21 所 示 。 


代码 解析 代码 中 引入 和 使 用 Result 类 的 方法 都 已 经 使 用 粗 体 标识 。logInfo 和 logPass 
都 直接 在 测试 方法 中 使 用 ; 而 logFail 方法 则 会 在 7.6 节 中 介绍 如 何 打 印 ， 它 会 在 assert 失败 


代码 清单 8-21 ”封装 日 志 模块 调用 


#!/usr/bin/env python 

lng 9. 一 汪 一 

from selenium import webdriver 

from selenium.webdriver.common.alert import Alert 
from time import sleep 

from DataPool import DataPool 

from Business import LoginModule 

from Dashboard import DashBoard 

from Result import Result 


dp = DataPool ('demo') 
wd = webdriver.Chrome () 
lm = LoginModule (wd) 
db = DashBoard (wd) 
result = Result() 


result.log_info('Open URL: %s' % dp.get('LOGIN URL')) 
wd.goto (dp.get ('LOGIN_URL')) 

lm.login(dp.get ('USERNAME'), dp.get('PASSWORD')) 
result.log info('Login Done') 

user name = db.get user name() 


sleep (1) 

Alert dp.get('USER DISPLAY NAME') == user_ name 
result.log pass() 

wd.close () 


时 自动 记录 。 
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至 此 ,使 用 Python 自 带 的 logging 模块 来 记录 测试 结果 的 方法 就 已 经 讲 完 ， 如 果 有 需要 
记录 更 多 日 志和 结果 信息 的 读者 可 以 查看 下 关于 logging 模块 的 更 多 支持 功能 。 


8.5.2” 自 定义 Logger 记录 


正常 情况 下 ， 我 们 使 用 Python 自 带 的 logging 模块 就 可 以 完成 结果 和 日 志 的 记录 功能 。 
其 特点 是 使 用 方便 、 快 捷 ， 只 需要 简单 的 封装 即 可 ; 不 足 之 处 就 是 需要 对 log 文件 进行 分 析 
才能 得 到 格式 化 的 结果 ， 不 利于 统一 的 管理 。 

除了 通过 logging 模块 记录 测试 结果 之 外 ， 还 可 以 自己 编写 一 个 自 定义 的 日 志 模 块 ， 专 
门 用 来 记录 测试 结果 和 测试 过 程 中 的 信息 。 其 使 用 方法 和 接口 可 以 与 8.5.1 节 保 持 一 致 ， 
而 内 容 则 是 记录 在 数据 库 中 。 其 特点 是 方便 查询 和 追溯 测试 结果 ， 便 于 测试 信息 的 查看 和 
提取 。 

本 节 讲 解 下 如 何 自 定义 一 个 Logger 模块 来 记录 测试 结果 ， 且 Logger 模块 提供 的 接口 与 
8.5.1 节 保持 一 致 。 即 提供 两 种 结果 记录 方法 ，5 种 日 志 信息 记录 方法 ; 最 终 都 将 会 被 记录 到 
数据 库 中 对 应 的 表 中 。 

首先 ， 按 照 惯例 先 来 列 一 下 数据 库 表 的 结构 ， 其 具体 字段 与 前 面 讲 到 的 两 个 表 稍 微 有 一 
些 差 异 ， 这 里 要 分 类 记录 不 同 的 日 志 类 型 和 等 级 ， 可 以 设计 两 张 表 分 别 用 来 记录 测试 结果 与 
测试 日 志 信息 ， 这 里 假定 结果 表 的 名 字 分 别 为 result、log， 其 表 结 构 如 下 所 示 。 

CREATE TABLE “result、( 

‘id int(11) NOT NULL AUTO_INCREMENT, 

“test_set、 varchar(255) DEFAULT NULL COMMENT ' 模块 名 '， 

“test_case ”varchar (255) NOT NULL COMMENT ' 测试 用 例 名 称 '， 
“test_method”varchar (255) NOT NULL COMMENT ' 测试 方法 名 '， 
“result、”enum('PASS','FAIL', 'ERROR') DEFAULT 'PASS' COMMENT ' 测试 结果 记录 '， 
“status、 enum('active', 'inactive') DEFAULT 'active' COMMENT ' 数据 是 否 有 效 '， 
“createAt ”date DEFAULT NULL COMMENT ' 创建 日 期 '， 


PRIMARY KEY (“id') 
) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8; 


CREATE TABLE ‘log ( 
“id* int(11) NOT NULL AUTO_INCREMENT, 
‘result _ id int(11) NOT NULL, 
“file_name ”varchar (255) DEFAULT NULL COMMENT ' 测试 日 志 调 用 的 文件 名 '， 
“func_name、varchar (255) DEFAULT NULL COMMENT ' 测试 日 志 调用 的 函数 名 '， 
“line_no”int (11) DEFAULT NULL COMMENT ' 测试 日 志 调用 的 行 号 '， 
`level、 varchar (255) DEFAULT NULL COMMENT ' 测试 日 志 等 级 '， 
“lo0g”varchar (255) DEFAULT NULL COMMENT ' 测试 日 志 信 息 '， 
“status、 enum('active','inactive') DEFAULT 'active' COMMENT ' 数据 是 否 有 效 '， 
“createAt ”date DEFAULT NULL COMMENT ' 创建 日 期 '， 
PRIMARY KEY (“id’) 

) ENGINE=InnoDB AUTO INCREMENT=1 DEFAULT CHARSET=utf8; 


200 及 Python Web 自动 化 测试 设计 与 实现 


代码 中 result 表 主 要 用 来 记录 测试 结果 ， 其 可 以 存 的 结果 类 型 有 PASS、FAIL、ERROR 
三 种 ， 分 别 记录 测试 通过 、 测 试 失败 、 测 试 异 常 的 情况 。log 表 用 来 记录 测试 过 程 中 的 调试 
信息 ， 以 result 表 中 的 id 作为 外 键 ， 可 以 通过 result 的 id 来 查询 其 对 应 调试 信息 。 

表 结 构 定 义 之 后 就 可 以 进行 数据 存 取 的 代码 封装 了 。 为 了 区 别 于 8.5.1 节 的 Result 类 ， 
这 里 使 用 DBResult 类 进行 数据 库存 储 操作 。 具 体 代码 参见 代码 清单 8-22。 


代码 清单 8-22 ” 自 定义 数据 库 日 志 模块 


class DBResult (object): 
def _init (self): 
self.__connect() 


def _del (self): 
self.cursor.close() 
self.db.close() 


def _connect (self) : 
self.db = MYSQLdb .connect ("localhost", "root", 
"root"nv "datapool" ) ## 数据 库 连 接 
self.cursor = self.db.cursor() ## 获取 游标 


def 1og_init (self，test_set，test_case，test_method) : 


sql = '''INSERT INTO result (test_set，test_case 
test method, result, createAt) 
VALUES ('%s','%s','%s','%s',now())'''" 条 


(test_set, test case, test method, 'FAIL') 
self.cursor.execute (sql) 
self.db.commit () 
return self.cursor.lastrowid 


def log pass (self，case) : 
return self. log result(case, 'PASS') 


def log faill(self, case): 
return self. log result(case, 'FAIL') 


def _ log resultl(self, case, result): 
sql = '''UPDATE result SET result='%s' 
WHERE id=%s''' % (result, 
case._class__.test_ result _ id) 
r= self.cursor.execute(sql) 
self.db.commit () 
return 工 


@findcaller 
def log debugl(self, case, msg, caller={}): 
return self. log info(case, msg, 'DEBUG', caller) 
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@findcaller 
def log infol(self, case, msg, caller={}): 
return self. log info(case, msg, 'INFO', caller) 


@findcaller 
def log warning(self, case, msg, caller={}): 
return self. log info(case, msg, 'WARNING', caller) 


@findcaller 
def log errorl(self, case, msg, caller={}): 
return self. log info(case, msg, 'ERROR', caller) 


@findcaller 
def log criticall(self, case, msg, caller={}): 


return self. log info(case, msg, 'CRITICAL', caller) 


def _ log infol(self, case, msg, level, caller={}): 


sql = '''INSERT INTO log (‘result id', ‘file name’, 
‘func name‘, line no‘, ‘level‘, ‘lo0g) 
VALUES ('%s','%S','%S','%S','%S','%S')'"'" % 


(case._class_ .test result id, 
caller.get ('file name'),caller.get('func name'), 
caller.get('line no'), level, msg) 
self.cursor.execute (sql) 
self.db.commit () 
return self.cursor.lastrowid 


代码 解析 代码 中 DBResult 为 主 类 ， 在 其 初始 化 时 进行 数据 库 的 连接 操作 ; 其 他 对 外 
可 访问 方法 与 8.5.1 节 中 的 保持 一 致 ， 唯 一 区 别 在 于 调用 时 传 入 的 参数 有 所 增加 。log_init、 
log_pass、log_ fail 记录 result 表 ，log_debug 、log_warning 、log_info 、log_error 、log_critical 记 
录 log 表 。 


按照 惯例 ， 最 后 演示 下 如 何在 测试 框架 中 引入 和 使 用 自 定义 的 Logger， 与 8.5.1 节 方式 
基本 一 致 ， 调 用 时 稍微 有 些许 差别 ， 具 体 见 代码 清单 8-23。 


代码 清单 8-23 “框架 中 集成 日 志 模块 


#!/usr/bin/env Python 

= BO WUE 

from selenium import webdriver 

from selenium.webdriver.common.alert import Alert 
from time import sleep 

from DataPool import DataPool 

from Business import LoginModule 

from Dashboard import DashBoard 
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from DBResult import DBResult 


class TestDemo (unittest.TestCase) : 
def setUp(self): 
self.dp = DataPool('demo') 
self.wd = webdriver.Chrome () 
self.lm = LoginModule (wd) 
self.db = DashBoard (wd) 
self.result = DBResult() 


def tearDown (self): 
self.wd.close() 


Q@name_ logger 
def test sample(self): 


self.result.log info(self, 'Open URL: %s' % self.dp.get('LOGIN_URL')) 


self.wd.goto(self.dp.get ('LOGIN_URL') 


self.lm.login(self.dp.get ('USERNAME'), self.dp.get('PASSWORD')) 


self.result.log info(self, 'Login Done') 
user name = self.db.get user name() 


sleep (1) 
Alert self.dp.get('USER DISPLAY NAME') == user name 
self.result.log pass(self) 


由 于 需要 记录 测试 用 例 名 称 等 相关 信息 ， 所 以 代码 中 以 单元 测试 的 方式 来 管理 用 例 代 
码 。 关 键 代码 已 用 粗 体 表 示 ， 分 别 为 DBResult 的 引入 、 实 例 和 使 用 。 与 8.5.1 节 稍 微 不 同 之 


处 在 于 ， 调 用 具体 的 方法 时 需要 传人 self 对 象 作为 第 一 个 参数 。 
此 外 ， 代 码 中 还 使 用 了 一 个 @name logger 装饰 器 ， 该 装饰 器 的 作 
的 名 称 ， 给 测试 用 例 添 加 test_result_id 属性 。 其 具体 内 容 如 下 。 


def name_logger (func) : 

def namelogger (self) : 

self._class_ .test_result_id = self.result\ 
“log _ init('', self._class_._name_,\ 
func. name ) ## 设 置 test_result_id 
self.result.log info('Test Class is:' 
+self._ class_ ._ name ) 

return func(self) 

namelogger. name =func. name __ 

return namelogger 


有: 记录 测试 用 例 


提示 之 所 以 需要 多 传 入 一 个 self 对 象 ， 是 因为 在 name logger 装饰 器 中 会 给 self 对 象 
的 _class ”属性 添加 test_result id 属性 ， 而 test_result id 则 是 插入 /更 新 数据 时 的 唯一 标识 
字段 。 
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8.5.3 ”邮件 通知 结果 

前 两 节 学 习 了 如 何 进行 测试 结果 与 日 志 的 定制 化 记录 。 而 在 测试 执行 完 之 后 ， 测 试 结果 
到 底 如 何 则 是 我 们 最 关心 的 ， 因 此 一 个 标准 的 自动 化 测试 框架 应 该 要 配备 一 个 自动 发 送 邮件 
的 功能 。 本 节 就 简 答 介绍 下 如 何 使 用 Python 进行 自动 的 邮件 发 送 ， 而 具体 的 测试 结果 的 统计 
与 邮件 体 样式 工作 ， 则 可 以 根据 自己 的 需求 来 进行 日 志 的 过 滤 和 筛选 。 

Python 中 自动 发 送 邮件 的 库 有 很 多 ， 这 里 使 用 的 是 smtp、email 库 ; 它们 配合 使 用 可 以 
很 方便 地 发 送 不 同类 型 的 邮件 ， 如 文本 类 型 、HTML 类 型 、 带 附件 类 型 的 。 具 体 的 发 送 邮件 
的 代码 见 代码 清单 8-24。 


代码 清单 8-24 ”邮件 发 送 模块 


#!/usr/bin/env python 
#encoding: utf-8 


from email.mime.multipart import MIMEMultipart 
from email.mime.base import MIMEBase 

from email.mime.text import MIMEText 

from email.utils import COMMASPACE, formatdate 
from email import encoders 

import smtplib 

import os 


def send maill(server, fro, to, subject, text, files=[]): 


assert typel(server) == dict 
assert type (to) == list 
assert type (files) == list 


msg = MIMEMultipart () 


msg['From'] = fro 

msg['Subject'] = subject 

msg['To'] = COMMASPACE.join(to) #COMMASPACE=="', ' 

msg['Date'] = formatdate (localtime=True) 

##msg.attach (MIMEText (text, 'text', 'utf-8')) ## 文本 类 型 邮件 体 
msg.attach (MIMEText (text, ‘'html', 'utf-8')) ##HTMIL 类 型 邮件 体 


for £ in files: 
part = MIMEBase('application'，'octet-stream') #binary data 
Part.set_payload (open (E，'rb') .read()) 
encoders.encode base64 (part) 
basename = os.path.basename (f) 
part.add header('Content-Disposition', 
"attachment; filename="%s"' % basename) 
msg.attach (part) 


smtp = smtplib.SMTP (server['name'], server['port']) 
smtp.ehlo() 
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smtp.starttls () 

smtp.ehlo() 

smtp.login(server['user'], server['passwd']) 
smtp.sendmail (fro, to, msg.as_string()) 
smtp.close() 


if _name ==' main _': 

server = {'name':'smtp.163.com', 
'user':'username', 
'passwd':'Ppassword', 


"port”s25} 
fro = 'username@163.com' 
to = ['to@163.com'] 
subject = '''title''’' 
text = r'''<p>EMAIL body</p>''"' 
files = ['attach]l .txt'] 


send maill(server, fro, to, subject, text) 


上 述 代码 需要 进行 一 下 简单 修改 ， 替 换 掉 其 中 的 邮箱 登录 账号 、 密 码 、 接 收 邮箱 、 主 
题 、 邮 件 体 及 附件 文件 的 路 径 等 。 如 果 账 号 和 密码 均 输 入 正确 ， 则 可 以 正常 地 发 送 邮件 。 


提示 ”在 使 用 账户 发 送 邮件 之 前 ， 需 要 确保 账户 的 SMTP 服务 功能 是 开启 的 ， 和 否则 会 提 
示 500 错误 ; 具体 的 开启 SMTP 服务 的 操作 ， 不 同 的 邮箱 服务 提供 商 其 设置 会 有 所 不 同 。 


8.6 ”异常 处 理 层 


异常 处 理 层 主要 是 用 来 统一 处 理 测试 过 程 中 的 各 种 异常 。 例 如 ， 元 素 未 找到 、 测 试 数据 
未 找到 、 断 言 异常 及 其 他 程序 运行 时 异常 等 。 在 前 面 已 经 多 次 接触 过 异常 处 理 的 代码 使 用 ， 
本 节 重 点 则 是 对 之 前 所 使 用 过 的 异常 处 理 函数 进行 梳理 和 说 明 。 

异常 处 理 在 测试 脚本 中 主要 分 为 两 类 ， 一 类 是 程序 运行 时 的 各 种 抛 出 异常 ， 另 一 类 是 
测试 断言 失败 所 抛 出 的 异常 。 由 于 这 两 类 异常 的 处 理 方式 有 所 不 同 ， 所 以 这 里 把 它们 分 开 进 
行 讲解 。 
8.6.1 程序 异常 处 理 

所 谓 的 程序 异常 在 这 里 主要 指 的 是 程序 运行 时 触发 的 各 类 异常 ， 例 如， 语法 错误 、None 
类 型 错误 。 另 外 还 包括 业务 层 的 错误 ， 例 如 ， 测 试 数据 未 找到 、 元 素 未 定位 到 、 初 始 化 失败 
等 错误 。 

在 Python 中 捕获 异常 的 方式 是 使 用 try 和 except 语句 来 处 理 ， 通 常 的 使 用 方式 是 将 可 能 
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会 抛 出 异常 的 代码 块 放 到 try 语句 下 ， 而 在 except 语句 下 则 是 异常 触发 后 的 响应 代码 。 当 然 
我 们 也 可 以 这 么 做 ， 但 是 那样 的 话 我 们 的 测试 用 例 函数 的 代码 可 能 如 代码 清单 8-25 所 示 的 形 
式 。 代 码 清单 8-25 以 BaiduHome 的 测试 用 例 代码 为 例 。 


代码 清单 8-25 异常 捕获 


def test sample (self): 

try: 
self.page.key worlds input (self.dp.get('SELENIUM')) 
self.page.search click() 
assert True 

except AssertionError, ex: 
print ex 
##Rssert 异常 处 理 ， 通 常 是 记录 到 结果 日 志 中 

except Exception, ex: 
print ex 


## 普通 异常 处 理 ， 通 常 是 记录 异常 日 志 中 


从 代码 中 可 以 看 出 ， 虽 然 测 试用 例 中 实际 的 测试 代码 只 有 三 行 ; 但 为 了 能 够 捕获 各 类 异 
常 并 记录 到 结果 或 日 志 中 去 ， 需 要 为 每 一 个 测试 用 例 都 添加 这 些 额 外 的 宛 余 代 码 。 虽 然 代码 
是 可 以 正常 工作 的 ， 但 是 却 不 够 灵活 。 那 么 有 没有 方法 可 以 把 这 些 处 理 异 常 的 代码 提取 出 来 
呢 ? 比较 好 的 一 个 选择 就 是 使 用 Python 的 装饰 器 来 封装 异常 处 理 代 码 。 

关于 Python 的 装饰 器 ， 在 前 面 的 章节 中 已 经 介绍 过 了 ， 可 以 把 它 理解 为 封装 函数 的 函 
数 ， 甚 至 是 封装 函数 的 函数 的 封装 函数 ， 也 就 是 嵌 套 封装 的 概念 。 它 的 特点 是 接受 一 个 函数 
对 象 作为 参数 ， 并 返回 一 个 与 原型 函数 一 致 的 函数 对 象 。 最 简单 的 一 个 装饰 器 可 以 是 下 面 代 
码 中 的 情况 。 


def foo(func) : 
def warpper() : ## 该 函数 的 参数 需要 与 func 的 参数 保持 一 致 
Print "execute %s' % func. name __ 
return func() 
return warpper 


该 装饰 器 接受 一 个 func 函数 作为 参数 ， 并 在 内 部 定义 了 一 个 与 func 函数 的 参数 形式 
一 致 的 warpper 函数 ， 即 warpper 函数 是 一 个 模仿 func 的 函数 。 其 中 ，warpper 函数 的 内 容 
就 是 进行 包装 时 所 需要 处 理 的 代码 ， 在 这 里 只 打印 了 一 条 执行 函数 名 的 日 志 。 最 后 返回 了 
warpper 函数 对 象 ， 而 此 时 warpper 函数 对 象 就 可 以 理解 为 被 装饰 过 后 的 func 函数 对 象 ， 这 
就 是 装饰 器 的 由 来 。 

在 前 面 的 框架 代码 中 ， 与 上 面 的 装饰 器 最 接近 的 装饰 器 是 @ name logger 装饰 器 ， 其 作 
用 就 是 用 来 记录 被 装饰 函数 所 在 Test Case 的 名 称 ， 因 为 在 测试 框架 中 需要 知道 当前 执行 到 哪 
个 测试 用 例 了 。 
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那么 ， 用 来 处 理 异 常 的 装饰 器 内 容 该 如 何 定义 呢 ? 在 理解 了 装饰 器 的 原理 之 后 ， 我 们 的 
异常 处 理 装饰 器 就 变 得 比较 简单 了 ， 具 体 而 言 就 是 在 warpper 函数 体 中 添加 异常 处 理 的 代码 。 
这 里 以 未 找到 元 素 异 常 的 情况 为 例 ， 介 绍 如 何 实现 一 个 异常 处 理 的 装饰 器 。 假 定 该 装饰 器 名 
称 为 @element not found_exception， 具 体 代码 见 代 码 清单 8-26。 


代码 清单 8-26 ”装饰 器 封装 异常 


def element not found exception (func) : 
def warpper (self, locator): 
Ey 
return funcl(self, locator) 
@xcept NoSuchElementException: 
print 'element not found for locator:',locator, 'At method:', 
func._ name __ 
return None 
return warpper 


在 上 述 代 码 的 warpper 函数 体 中 使 用 了 try 和 except 语句 来 捕获 异常 ， 并 且 把 被 装饰 的 
函数 直接 放 在 try 语句 下 ， 这 样 一 旦 被 装饰 的 函数 在 执行 时 抛 出 了 对 应 的 异常 就 会 自动 捕获 
并 记录 。 这 里 只 捕获 了 NoSuchElementException 异常 ， 而 其 他 类 型 的 异常 则 会 作为 普通 程序 
异常 在 用 例 层 被 捕获 。 

除了 上 面 提 到 的 两 个 装饰 器 之 外 ， 还 有 一 个 通用 的 异常 装饰 器 ， 用 来 捕获 所 有 类 型 的 异 
常 。 这 样 就 可 以 把 测试 过 程 中 的 所 有 异常 都 进行 分 类 和 记录 。 通 用 异常 装饰 器 的 代码 内 容 如 
代码 清单 8-27 所 示 。 


代码 清单 8-27 通用 异常 装饰 器 


def exception logger (func): 
def warpper (self): 
ts 
return func(self) 
except Exception, ex: 


Print Exception,":",ex.message, 'At method:', func. _ name __ 
print sys.exc info() 
# print traceback.print exc() ## 打印 完整 堆栈 用 于 定位 代码 行 


return warpper 


该 异常 装饰 器 也 只 是 在 捕获 异常 之 后 打印 异常 信息 ， 并 且 可 以 支持 打印 程序 异常 的 堆栈 
信息 。 代 码 中 对 堆栈 信息 的 打印 提供 了 两 种 方式 ， 具 体 可 以 根据 自己 的 需求 来 选择 ， 使 用 前 
注意 要 引入 对 应 的 支持 库 。 

接 下 来 ， 再 来 回顾 下 在 用 例 层 应 当 如 何 使 用 异常 装饰 器 。 这 里 直接 以 BaiduHome 的 测 
试用 例 代码 来 展示 ， 具 体 的 用 例 代码 见 代 码 清单 8-28。 
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代码 清单 8-28 ”异常 装饰 器 使 用 


#!/usr/bin/env python 

大 = coding: utf-8 -*— 

from selenium import webdriver 

from selenium.webdriver.common.alert import Alert 
from time import sleep 

from DataPool import DataPool 

from Business import LoginModule 

from Dashboard import DashBoard 

from DBResult import DBResult 

from ExceptionWarpper import * 


class TestDemo (unittest.TestCase): 


@exception logger 

@name_ logger 

def setUp (self): 
self.dp = DataPool ('demo') 
self.wd = webdriver.Chrome () 
self.lm = LoginModule (wd) 
self.db = DashBoard (wd) 
self.result = DBResult () 


Qexception logger 
def tearDown (self): 
self.wd.close() 


Qexception_ logger 
def test_sample (self): 
self.result.log_info('Open URL: %s' % self.dp.get('LOGIN_URL')) 
self.wd.goto(self.dp.get ('LOGIN URL') 
self.lm.login(self.dp.get ('USERNAME'), self.dp.get('PASSWORD')) 
self.result.log info('Login Done') 
user name = self.db.get user name() 


sleep (1) 
Alert self.dp.get('USER DISPLAY NAME ') == user name 
self.result .lo0g pass() 


与 代码 清单 8-25 相 比 ，test_sample 测试 方法 中 现在 只 需要 编写 具体 的 业务 代码 即 可 ， 而 
关于 异常 处 理 的 代码 都 可 以 省 略 掉 。 与 此 同时 ， 通 过 添加 @exception_ logger 异常 装饰 器 来 
处 理 测试 过 程 中 抛 出 的 通用 异常 。 

另外 ， 还 可 以 看 到 除了 test_sample 测 试 方法 之 外 ，setUp、tearDown 方 法 也 使 用 
@exception logger 异常 装饰 器 ， 这 样 处 理 同一 种 类 型 的 异常 代码 只 需 实现 一 份 。 同 样 


oF 
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@name logger 装饰 器 被 用 在 了 setUp 之 上 ， 用 来 专门 记录 当前 测试 用 例 所 在 类 名 。 
最 后 ， 还 有 一 个 需要 注意 的 地 方 就 是 setUp 和 test_sample 方法 都 使 用 了 两 个 装饰 器 , 那 
么 这 两 个 装饰 器 与 被 装饰 方法 之 间 的 关系 是 怎样 的 呢 ? 


提示 “从 代码 清单 8-28 中 ， 可 以 注意 到 setUp 和 test_sample 方法 都 同时 使 用 两 个 装饰 
器 ， 这 两 个 装饰 器 的 执行 顺序 分 别 是 : name logger、exception logger。 即 name logger 装饰 
的 对 象 是 setUp， 而 exception_ logger 装饰 的 对 象 则 是 name_ logger。 所 以 它们 的 顺序 不 能 颠 
倒 ， 否则 记录 的 信息 和 捕获 异常 的 范围 将 与 期 望 不 一 致 。 


细心 的 读者 可 能 会 发 现 ， 代 码 清单 8-28 中 并 没有 使 用 到 @ element_not_found_exception 
装饰 器 。 原 因 是 该 装饰 器 用 于 捕获 元 素 未 找到 异常 ， 所 以 它 装饰 的 对 象 在 页 面 操作 层 。 准 确 
地 说 ， 它 只 需 用 来 装饰 PageBase 类 中 的 get_element 和 get_elements 对 象 即 可 。 具 体 详 见 代 
码 清单 8-11。 


8.6.2 断言 异常 处 理 


断言 异常 是 测试 用 例 中 独 有 的 一 类 异常 ， 通 常 是 在 判断 结果 失败 时 抛 出 ， 这 样 我 们 就 可 
以 知道 用 例 执行 过 后 到 底 有 没有 通过 。 在 这 里 把 断言 异常 拿 出 来 单独 讲 ， 主 要 是 因为 其 他 异 
常 处 理 时 ， 只 需要 简单 地 打印 日 志 即 可 。 对 于 断言 异常 有 一 个 需要 额外 处 理 的 就 是 统计 断言 
失败 的 数量 和 测试 名 ， 这 样 在 全 部 的 测试 用 例 执行 完 之 后 就 可 以 很 容易 地 得 到 一 个 测试 通过 
率 的 统计 结果 。 


提示 Python 的 单元 测试 框架 本 身 也 带 了 统计 测试 通过 和 失败 的 日 志 ， 但 信息 量 都 非常 
简单 ， 如 果 在 你 的 框架 里 需要 能 够 获得 更 多 的 测试 过 程 数 据 ， 那 么 就 可 以 考虑 使 用 断言 异常 
来 记录 相关 需要 用 到 的 信息 了 。 


关于 断言 处 理 装饰 器 的 内 容 ， 与 前 面 的 异常 处 理 装饰 器 基本 一 致 。 只 不 过 我 们 在 捕获 到 
具体 的 断言 异常 之 后 ， 所 要 记录 的 信息 要 多 一 点 儿 、 有 针对 一 点 儿 。 具 体 记 录 哪 些 信息 、 以 
什么 方式 记录 则 要 依据 最 后 统计 数据 时 的 需求 而 定 。 这 里 只 列 出 断言 处 理 装 饰 器 的 雏形 代 
码 ， 具 体 见 代码 清单 8-29。 


代码 清单 8-29 ”处 理 断言 装饰 器 


def assert logger (func): 
def warpper (self): 
try: 
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print "Test Case is:', func. name__ 
return func(self) 
except AssertionError, ex: 
print 'AssertError in: %s.%s', (self. Cclass . name , func. name ) 


## 打印 了 当前 的 测试 用 例 和 测试 方法 名 


warpper. name =func. name _ 
return warpper 


8.6.3” 自 定义 异常 类 


自 定义 异常 是 根据 具体 的 需要 ， 通 过 继承 Exception 类 来 定义 的 一 个 新 异常 类 型 。 前 面 
使 用 了 两 个 自 定义 的 异常 ， 在 这 里 就 把 这 两 个 异常 的 定义 原型 给 列 出 来 ,具体 见 代码 清单 
8-30。 


代码 清单 8-30 ” 自 定义 异常 


class NOTESTDATAERROR (Exception): 
def _init (self, module, test case, name): 
self.value = '%s: Module: %s, TestCase: %s, Name: %s' % (self. name_, 
module, test case, name) 
def str (self): 
return repr(self.value) 


class NOLOCATORERROR (Exception): 
def _init __(self, module, test case, name): 
self.value = '%s: Module: %s, TestCase: %s, Name: %s' % (self._name_， 
module, test_case, name) 
def _ str__ (self): 
return repr(self.value) 

代码 中 的 两 个 自 定义 异常 分 别 是 NOTESTDATAERROR 和 NOLOCATORERROR， 它 们 
对 应 的 触发 场景 分 别 是 获取 测试 数据 失败 时 及 获取 定位 符 失败 时 。 这 两 个 异常 分 别 在 8.1.2 
节 与 8.2.2 节 的 代码 清单 中 使 用 过 ， 而 最 终 它们 都 将 在 用 例 层 被 @exception_logger 装饰 器 所 
捕获 并 记录 。 

到 此 为 止 ， 关 于 自动 化 框架 的 设计 与 实现 部 分 都 已 经 讲 完 。 正 如 前 面 所 提 到 的 一 样 ， 进 
行 框架 设计 的 目的 是 为 了 功能 复 用 与 代码 解 耦 ， 最 大 程度 地 降低 后 期 代码 维护 的 成 本 ， 让 自 
动 化 脚本 能 够 轻快 到 跑 起 来 。 在 实际 的 自动 化 项 目 中 ， 并 非 一 定 要 用 到 自动 化 框架 或 者 平 
台 ， 一 切 以 能 否 真正 解决 问题 为 前 置 条 件 。 

由 于 前 面 都 是 分 开 单独 讲解 的 ， 重 点 关注 在 单个 文件 内 的 代码 上 ， 而 对 于 各 代码 文件 之 
间 的 互相 引入 并 没有 一 一 说 明 ， 为 了 能 够 对 框架 整体 的 结构 有 一 个 认识 ， 在 这 里 对 经 过 整理 
后 的 测试 框架 目录 结构 做 一 个 截图 展示 ， 具 体 如 图 8-3 所 示 。 
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v OD Python Book (C\Users\Administrator\Desktop\PytH 
> Business 
思 Data 
珀 Erors 
思 Locator 
证 Pages 
Result 
ED TestCases 
应 _init_.py 
应 db_page callpy 
应 module_ callpy 
网 module page callpy 
网 page calLpy 
目 testinfo.log 
testresultlog 
目 README.md 
| 


图 8-3 测试 框架 目录 结构 
另外 ， 此 项 目 已 经 上 传 到 GitHub 上 ， 具 体 地 址 为 https://github.com/five3/psaf， 现 在 是 
初级 版 本 ， 后 期 会 进行 一 些 功能 上 的 升级 ， 有 需要 的 读者 请 在 GitHub 上 关注 即 可 。 
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第 9 章 


测试 脚本 部 署 


CHAPTER 


当 在 本 地 机 器 上 对 测试 脚本 进行 开发 并 测试 完成 之 后 ， 就 需要 对 自动 化 脚本 进行 提交 并 
统一 管理 和 部 署 ， 这 一 点 与 产品 开发 的 代码 一 样 。 因 为 通常 测试 脚本 可 能 是 由 多 名 测试 人 员 
一 起 进行 编写 的 ， 在 多 人 协作 进行 开发 的 时 候 ， 测 试 脚本 就 需要 统一 进行 管理 ， 这 样 项 目 中 
的 每 一 个 人 都 可 以 很 方便 地 获取 到 全 部 的 测试 脚本 ， 并 且 可 以 规范 使 用 统一 的 脚本 启动 方式 
来 启动 测试 脚本 ， 规 避 不 同人 员 开 发 脚本 和 使 用 脚本 的 差异 性 。 本 章 将 介绍 如 何 对 测试 脚本 
进行 统一 管理 和 部 署 。 


9.1 使 用 SVN 管理 测试 脚本 


管理 测试 脚本 可 以 直接 参考 产品 代码 的 管理 流程 ， 这 里 要 引入 一 个 概念 就 是 代码 管理 
工具 。 代 码 管理 工具 就 是 帮助 我 们 对 开发 的 代码 (脚本 ) 进行 统一 管理 的 工具 ， 其 主要 特点 
如 下 。 

口 支 持 统一 管理 和 存储 代码 。 

口 支 持 多 版 本 控制 。 

口 支持 多 分 支 开发 。 

口 支持 历史 操作 查询 。 

口 支 持 代码 变动 的 检查 。 

口 支 持 自动 代码 整合 及 冲突 提醒 。 


令 
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上 述 特 点 只 是 代码 管理 工具 最 常 使 用 的 部 分 功能 ,通常 代码 管理 工具 还 有 更 多 其 他 
的 功能 用 于 支持 我 们 的 日 常 开发 工作 ， 这 里 暂 不 做 介绍 ， 有 兴趣 的 读者 可 以 进行 延伸 
阅读 。 

关于 代码 管理 工具 的 选择 目前 比较 流行 的 有 SVN、GIT、VSS、CVS 等 。 日 常 工作 中 最 
经 常 接触 到 的 应 该 就 是 SVN 了 ， 主 要 原因 是 它 在 Windows 下 提供 支持 UI 图 形 化 的 客户 端 ， 
使 用 起 来 更 加 简单 和 方便 ， 不 需要 记 住 各 种 操作 命令 ， 所 以 本 节 以 SVN 作为 代码 管理 工具 
来 介绍 如 何 管理 测试 脚本 。 

SVN 代码 管理 工具 是 由 两 个 部 分 组 成 ， 一 个 是 SVN 服务 ， 另 一 个 是 SVN 客户 端 。 服 务 
端 用 来 统一 管理 和 存储 全 部 代码 ， 客 户 端 是 用 于 从 服务 端 检 出 、 向 服务 端 检 入 代码 的 本 地 工 
具 。 通 常 SVN 服务 端 是 安装 在 网 络 中 的 某 一 台 服 务 器 上 ， 而 客户 端 则 是 安装 在 开发 者 本 地 
的 机 咒 上 。 

SVN 的 服务 端 和 客户 端 都 有 很 多 个 版 本 ， 分 别 可 以 支持 不 同 的 平台 。 例 如 ，Linux 下 有 
Subversion，Windows 下 有 VisualSVN Server 服务 端 和 TortoiseSVN 客户 端 。 这 里 将 介绍 在 
Windows 环境 下 安装 和 使 用 SVN 的 服务 端 和 客户 端 。 


9.1.1 SVN 服务 安装 
(1) 进入 VisualSVN Server 下 载 页 ， 如 图 9-1 所 示 。 


https://www.visualsvn.com/server/download, 


Mp RVER 


VISUALSVN VISUALSVN SERVER // Download 


VISUALSVN SERVER 


overvilew 
features 


Screenshots 
Te] 
getting started VISUALSVN SERVER 
version history 
customers 


7 Includes Apache 
32-bit | 64-bit Subversion 1.9.5 
COMPANY 


SUPPORT VERSION 3.6.0 ~10 MB 


ETN ， 


图 9-1 SVN Server 下 载 页 


(2 ) 选择 相应 的 版 本 下 载 安装 文件 (本 文中 的 安装 文件 地 址 为 : https://www.visualsvn. 
com/files/Visual SVN-Server-3.6.0-x64.msi) 。 
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(3 ) 双击 打开 下 载 的 安装 文件 ， 并 同意 安装 条 款 ， 如 图 9-2 所 示 。 
(4 ) 选择 第 一 个 选项 ， 并 单 击 Next 按钮 ， 如 图 9-3 所 示 。 


VREVN server 3.6.0 Setup ele yy VisualSVN Sever = 
Select Components | VisualSVN Server Editions 
Please select components you woud lke to nstal Piease seiect whdh edbon of VisualSVN Server you'd we to nstal. 
You can either choose to perform the ful nstalation of VisualSWN Server or oniy nstal There are two edibons of VisualSN Server avalable and dependng on your needs you 
the corresponding admnistration tools. Please seiect components you want to be an choose which one suits you best, 


| sencerdedon | 
A Ry functional server ¥ der Truly 
free of charge and permitted for 


| Gee 


The best option for SMB and enterprises. Provides additional features such as 
Active Drectory Sngle Sign-On and Remote Server Administration. 


© Admnistration Tools Orly 
Instal MMC snap-n, PowerShell module and Subversion command-ine tools to 
admnister VisualSVN Server instances nstaled on other computers. 


[ Add subverson command -ine tools to the PATH envronment varable 


ee re 
Cs J ] (Cone |] [er Cancel 
图 9-2 SVN Server 安装 向 导 1 图 9-3 SVN Server 安装 向 导 2 


(5 ) 单 击 Standard Edition 按钮 ， 进 入 安装 目录 选择 界面 ， 如 图 9-4 所 示 。 
(6) 设置 相应 的 服务 配置 信息 ， 单 击 Next 按钮 并 执行 安装 ， 如 图 9-5 所 示 。 


于 VisualSVN Server3.60 Visuals .60 Set (= 


Initial Server Configuration 
Please adjust the default configuration settings if necessary. 


Completing the VisualSVN Server 3.6.0 
Setup Wizard 


Chck the Finish button to et the Setup Wizard, 


[EProgram Fies WeualSW Server\ 


回 Subsaibe for release notifications via emal or RSS 


| : » ere mecn ope te 


FE:Wsers Public Documents WisualSWN Server Badaup\ 
@ 


VISUALSVNSERVER 


mr) [ca 


[Bk ]L_ see 


图 9-4 SVN Server 安装 向 导 3 图 9-5 SVN Server 安装 向 导 4 


(7 ) 勾 选 Start VisualSVN Server Manager 复 选 框 并 单 击 Finish 按钮 启动 管理 界面 ， 如 图 
9-6 所 示 。 

(8) 右 击 Repositories 选项 ， 在 弹出 的 快捷 菜单 中 执行 Create New Repository 命令 ， 如 
图 9-7 所 示 。 

(9 ) 进入 Create New Repository 对 话 框 ， 如 图 9-8 所 示 。 
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文件 昌吉 作 人 查看 WO 于 二 


名 四国 SG 加 可 | 村 | 


[© vsualsvN Sever (ecal 
» Repositories 
BB users 
局 Groups 
加 obs 


Status 
HTTF 
VDFS 


VISUALSVNSERVER 
EE 


semviceis running 
Semviceis disabled Enable | 
BackgroundJob servceis running | 


‘Upgrade to Enteprise Edition 
Compare Editions 


lisabled 
Operalional Iogging is disabled 
Dpen Evert Mewer 

Configure logging. 


Repositories 
Tolal 0 repositories. 


Creale new reposhory, 
pastory 


» supscnde tor Upaates 


2 Provaeresaeace ，veraonaso 


图 9-6 SVN Server 管理 界面 


HN FN EW) BND) 
名 中 | 六 国 加 也 | 四 可 | 面包 
@ visualSvN Server (Local) 


国 Reposito 

DD Users ol 
BGroups | mport Ededng Rep 

局 Jobs ey 


Restore Repository.. 
新 建 (N) 


所 有 任务 (9) 
村 看 NV) 


ial 
导出 列表 (D- 


帮助 (H) 


图 


9-7 创建 SVN 仓库 


5 上 -本 @ 攻 = 生硬 Rs) 


图 9-8 选择 SVN 仓库 类 型 


| 


( 10 ) 选中 Regular FSFS repository 单 选 按钮 ， 并 单 击 “ 下 一 步 ”按钮 ， 如 图 9-9 所 示 。 


(11 ) 输入 新 建仓 库 的 名 称 ， 并 单 击 “ 下 一 


步 ” 按 钮 ， 如 图 9-10 所 示 。 


〈12 ) 选中 第 一 个 单 选 按钮 ， 单 击 “ 下 一 步 ” 按 钮 创建 一 个 空 的 仓库 ， 如 图 9-11 所 示 。 
(13 ) 选中 第 二 个 单 选 按钮 ， 设 置 所 有 用 户 都 有 读 写 权 限 ， 单 击 Create 按钮 完成 仓库 创 


建 ， 如 图 9-12 所 示 。 


(14) 查看 SVN 管理 面板 ， 此 时 新 仓库 已 创建 完成 ， 如 图 9-13 所 示 。 


至 此 已 完成 SVN 服务 端的 安装 与 仓库 创建 ， 接 下 来 还 要 继续 为 SVN 服务 创建 用 户 ， 上 
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月 


于 访问 SVN 的 仓库 。 具 体 创 建 用 户 的 方法 步骤 如 下 。 


(1) 在 SVN 管理 面板 右 击 Users 选项 ， 在 弹出 的 快捷 菜单 中 执行 Create User… 命 令 ， 如 
图 9-14 所 示 。 


Create New Repository 


Reposi tary ms 
be une 国 


You can aeaie the deaiedrepoatery sbuchue later using the Create Foder or Create Project 
y. 


Sruchre cortext new commarde fo the aeated 


Learn more epout the recommerded reposiory yout 


EE 三 司 EE 
9-9 设置 SVN 仓库 名 9-10 设置 SVN 仓库 结构 


Create New Repository 


Repository Access Permissions 


Repository Created Saccessfolly 
Sprcify initinl aceezs pernissions For the new repesitory 


Please review the createi repository tetails 


a Ea 
回 加 


Set the kind of permisions you want or the new repository. 
Nobody has acee 


Repository Type: FSFS 
Repository Nome: pasf 


Repository LRL: htt /fnacy PC/sn /oasf 
Repository access permissions can be adiusted later using the Properies cr Marace Seauriy 
centext menu commands for the createdreoository. 
ss Bnish 取消 ] 
图 9-11 设置 SVN 仓库 权限 图 9-12 ”SVN 仓库 创建 完成 
团 vsuslSvN Server 原 veuaswsnve RS -一 
文人 (有 过 作 (A) 查看 M) 文 HD 给 fF(A) 和 宣 看 VM 才 D(H) 
中 | 方 国 | | 多 中 | 方圆 XX 9 已 | 日 富 | 久 | 加 白 
四 visualsvN Server Local | 四 visualsvN Server (Local) 
2 国 Repesitories 4 Repositories 
a past 
rp 
-人 
图 9-13 查看 SVN 仓库 图 9-14 创建 SVN 用 户 


(2) 在 Create New User 对 话 框 中 输入 用 户 名 和 密码 ， 并 单 击 OK 按钮 ， 如 图 9-15 所 示 。 
(3 ) 在 SVN 管理 面板 单 击 Users 选项 ， 查 看 创建 的 用 户 ， 如 图 9-16 所 示 。 
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项 VisuaSVN Server 一 
| New User 3 


文件 (F) 操作 (A) 查看 (V) 帮助 (H) 
启 外 | 方 国 | G 忆 | 日 富 | 画 折 
oo VisualSVN Server (Local) 
Name 
@ user name and password are case sensitive. 
Co (one | 
图 9-15 设置 SVN 用 户 名 及 密码 图 9-16 ”SVN 用 户 查看 


用 户 创建 完成 之 后 ， 就 可 以 使 用 创建 的 用 户 来 访问 之 前 创建 的 仓库 了 (本 文中 为 pasf 仓 
库 ); 但 在 此 之 前 还 需要 获取 到 要 访问 的 仓库 具体 地 址 ， 具 体 的 获取 方式 如 下 。 

(1) 在 SVN 管理 面板 上 右 击 具体 的 仓库 名 (本 文 为 pasf)， 如 图 9-17 所 示 。 

(2 ) 在 弹出 的 快捷 菜单 中 执行 Copy URL to Clipboard 命令 ， 获 取 仓库 访问 地 址 到 粘贴 板 。 

(3 ) 打开 浏览 器 ， 在 地 址 栏 中 粘贴 仓库 的 URL (本 文中 的 访问 地 址 为 http://localhost/ 
svn/pasf/)， 如 图 9-18 所 示 。 


VisualSVN Server WW 重 二 
文件 月 昌 fF(A) 查看 (V。 帮 册 (H) 


D ocalhost/swn/past/ 


a , 
; 
et Ld 
新 建 (N] » 


所 有 任 各 (K) 上 
查看 MV) 


图 9-17 复制 SVN 仓库 地 址 图 9-18 访问 SVN 仓库 地 址 
(4) 输入 前 面 创建 的 用 户 名 和 密码 (tester:tester)， 登 录 成 功 后 显示 的 页 面 如 图 9-19 所 示 。 


图 9-19 ”SVN 仓库 登录 成 功 


提示 本 节 以 VisualSVN Server 为 例 介绍 SVN 服务 端的 安装 与 配置 ， 主 要 是 因为 其 自 
身 集 成 了 Subversion 和 Apache 相关 服务 ， 可 以 更 加 方便 地 搭建 和 配置 SVN 服务 ; 此 外 ， 
Subversion 还 支持 在 Linux 平台 下 搭建 SVN 服务 ， 同 样 地 ，Linux 平台 下 也 有 支持 图 形 化 的 
SVN 管理 软件 ,例如 SVNManager。 
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9.1.2 ”SVN 客户 端 安装 


(1 ) 进入 TortoiseSVN 下 载 页 (https://tortoisesvn.net/downloads.html)， 如 图 9-20 所 示 。 


& 安全 | httpsy/tortolsesvn net/downloads html 


| 
TortoiseSVN 
mb Downloads 
The current version is 1.9.5 
A 
LE] 
TS 


foryeur PC othe vise the setup will fol 


Please make sure hat you choose the right neta 


for 32-bit OS for 64-bit OS 


cnnb EEC 


Herty folow tose ssst 


图 9-20 SVN 客户 端 下 载 页 面 


(2 ) 选择 相应 的 版 本 进行 下 载 (本 文 的 下 载 地 址 为 https://nchc.dl.sourceforge.net/project/ 
tortoisesvn/1.9.5/Application/TortoiseSVN-1.9.5.27581-x64-svn-1.9.5.msi)。 

(3) 在 页 面 的 下 部 还 可 以 下 载 对 应 的 中 文 语言 包 (本 文 的 下 载 地 址 为 https:/nchc. 
dl.sourceforge.net/project/tortoisesvn/1.9.5/Language%20Packs/LanguagePack_1.9.5.27581-x64- 


zh_CN.msi)。 
(4) 双击 TortoiseSVN 客户 端 安装 文件 ， 并 同意 安装 条 款 ， 如 图 9-21 所 示 。 
(5 ) 选择 客户 端的 安装 位 置 ， 并 单 击 OK 按钮 ， 如 图 9-22 所 示 。 


Wy TortoiseSVN 1.9.5.27581 (64 BI Setup "Ey 其 TortoiseSVN 19.5.27581 (64bit) Setup a 一 | 
Custom setup Change current destination folder 
Pik an netal ocason and wh featres yo want Browse to he destnaten foider 
ick on the cons in the tee be to change the way features wil be retaled, TR a 
i Lookn: Cj TortosesWN Le 
The TortoseSYN pacdage and 
dependences. 
Featre Sze 
This feature requires 38MB on your 
hard crive. Ithas 5of6 
selected. The 
‘ 可 » | subfeatures requre 7509B. 
一 — 
Ghee) (Bebe) ecaEEE 上 ee Eee Cs 
图 9-21 SVN 客户 端 安装 向 导 1 图 9-22 SVN 客户 端 安装 向 导 2 


(6) 单 击 Install 按钮 并 完成 安装 ， 如 图 9-23 所 示 。 
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(7 ) 安装 完成 后 重启 计算 机 。 

至 此 ，TortoiseSVN 客户 端 已 经 安装 完成 。 要 确认 是 否 已 安装 成 功 ， 则 可 以 在 桌面 或 
者 文件 夹 的 任意 空白 处 右 击 ， 如 果 在 弹出 的 快捷 菜单 中 有 SVN 命令 则 表示 安装 成 功 ， 如 图 
9-24 所 示 。 


划 TortoiseSVN 1.9.5.27581 (64 bi Setup 
查看 MV) » 
Ready to Install 排序 方式 (O) » 
| The Setup Wizard is ready to begin the Custom nstalaton 2) 机 
Pe Ri(E) 
Chick Install to begin the installation, If you want to review or dhange any of your 自 定 义 文件 夹 (月 … 
installation settings, cick Back. Cidk Cancel to exit the wizard. 
壤 贴 (P) 
车 贴 快 皇 方 式 (S) 
共享 (H) , 
因 “SVN Checkout.. 
全 TortoiseSVN » 
国 ” 共享 文件 夫 同 步 
新 建 (W) » 
ED 二 二 去 
图 9-23 SVN 客户 端 安装 向 导 3 图 9-24 SVN 客户 端 菜 单 


接 下 来 ， 要 对 中 文 包 进 行 安装 和 语言 配置 ， 具 体 的 操作 步骤 如 下 。 

(1) 双击 SVN 客户 端 中 文安 装 包 。 

(2 ) 单 击 Next 按钮 以 默认 配置 完成 安装 。 

〈3 ) 在 桌面 空白 处 右 击 ， 在 弹出 的 快捷 菜单 中 执行 TortoiseSVN 命令 ， 如 图 9-25 所 示 。 
(4 ) 执行 Settings 命令 ， 进 入 设置 界面 ， 如 图 9-26 所 示 。 


是 siro room na 民品 
排序 方式 (O) ， A General -| en 
分 依据 P) ， 六 Tortoisesm 
A Dialogs 1 i 
新 (日 re Lnguage 
和 定义 文件 夫人. 和 Dialoos3 Thc Eor iates i: A 人 天 | 
YY colors 
6(P) sh Revison Graph Ma (7)| 
入 巾 快 扫 方 式 (S) | YW colors vse Meo aaoe 
“全 lon Owen 
二 | ey Groat HA en 
困 swN checkout. | | SS oe wa samsie 
全 ToroisesvN 人 Soba iamere pattern oro bnew i 
加 ”共享 文件 夫 局 步 | ¥ Merge Toal 可 se cne dates to the ast eomit tine” 
ewe shen et ation file: ee) 
RW) a Sobversim emfi guration fl 
屋 性 (R) |] cached Repcositories 
这 Hook Scripts 
LS lecwe Trackarlaageat 民 
aa， 
了 -一 一 
EL ai | ge 部 助 
L E 本 , 
图 9-25 SVN 客户 端 设 置 人 口 图 9-26 SVN 客户 端 设置 界面 


(5 ) 在 语言 下 拉 列 表 框 中 选择 “中 文 (简体 ， 并 单 击 “ 确 定 ” 按 钮 。 
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(6) 设置 完成 之 后 ， 在 桌面 空白 处 右 击 并 查看 。 一 融 # 一 一 一 
TortoiseSVN 命令 ， 如 图 9-27 所 示 。 2 
目前 SVN 的 客户 端 TortoiseSVN 及 其 中 文 语言 包 Rr 
都 已 经 安装 完成 ， 之 后 就 可 以 使 用 SVN 客户 端 来 访 机 而 
问 SVN 仓库 ， 并 从 仓库 中 获取 代码 及 提交 本 地 代码 i 
到 仓库 中 。 具 体 的 操作 流程 在 9.1.3 节 中 将 进行 介绍 。 sna 
~ 了 蒜 一 
提示 通过 浏览 器 可 以 直接 访问 SVN 的 仓库 ， 二 


属性 (R) 


为 什么 还 要 再 安装 SVN 客户 端 呢 ? 因为 浏览 器 只 能 
对 仓库 中 的 代码 进行 查看 ， 不 具有 代码 提交 、 文 件 比 
对 、 历 史 查 询 等 功能 。 


图 9-27 SVN 菜单 中 文 界面 


9.1.3 ”SVN 使 用 简介 


在 SVN 的 服务 端 、 客 户 端 均 已 安装 配置 完成 之 后 ， 就 可 以 正常 使 用 SVN 来 管理 测试 代 
码 了 。 日 常 工作 中 最 常用 的 SVN 功能 有 代码 检 出 、 代 码 更 新 、 代 码 检 入 、 冲 突 处 理 、 查 看 
代码 改动 、 查 看 代码 提交 历史 等 ; 除 此 之 外 ，SVN 还 具有 版 本 控制 和 分 支管 理 的 功能 ， 感 兴 
趣 的 读者 可 以 进行 延伸 阅读 。 这 里 将 对 SVN 的 常用 功能 进行 简单 介绍 。 

代码 检 出 : 是 指 从 仓库 地 址 中 导出 一 份 完整 的 项 目 代 码 ; 例如 ， 针 对 某 一 项 目的 全 部 测 
试 脚本 。 代 码 检 出 是 从 无 到 有 的 过 程 ， 相 当 于 把 SVN 服务 端 仓库 中 的 所 有 内 容 进 行 一 个 复 
制 到 本 地 的 过 程 。 具 体 的 代码 检 出 的 操作 如 下 。 

(1 ) 在 准备 存放 代码 的 目录 空白 处 右 击 。 

(2 ) 选择 “SVN 检 出 ”选项 ， 如 图 9-28 所 示 。 

(3 ) 在 “版 本 库 URL” 栏 中 输入 获取 到 的 SVN 仓库 地 址 (本文 为 http://localhost/svn/ 
pasf/)， 如 图 9-29 所 示 。 


图 9-28 SVN 检 出 


EW Ea) 
排序 方式 (D) | 
分组 依 撕 加 | 
BE "| 国 
和 证 文件 夫 (R， 国明 
攻 贴 (P} 口 多 个 、 钞 空 的 工作 避让 四 
相 巾 快捷 方式 (S) 检测 肝癌 虽 ) 
SH) » [aa 3 
edn EE | 
全 TortoiseSVN » 版 本 
EE: 27 Loi 
© EE 7 
i EE 
层 作风 ME ] [一 B 汶 -| Li- 


图 9-29 SVN 地 址 输入 
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(4) 在 “ 检 出 至 目录 ” 栏 中 输入 将 要 存放 代码 的 地 址 ， 并 单 击 “确定 ”按钮 ， 如 图 9-30 
所 示 。 
(5 ) 输入 用 户 名 和 密码 (tester:tester)， 并 单 击 “ 确 定 ” 按 钮 ， 如 图 9-31 所 示 。 


图 9-30 输入 SVN 用 户 名 及 密码 图 9-31 SVN 检 出 成 功 
(6) 查看 检 出 目录 中 代码 进行 确认 。 


提示 ”由 于 之 前 创建 的 是 一 个 空 的 仓库 ， 因 此 当 访 问 检 出 目录 C:\Users\macy\Desktop\ 
pasf 时 ， 该 目录 中 将 不 会 有 任何 内 容 。 


代码 检 入 : 是 指 将 本 地 “ 检 出 目录 ”中 新 增 、 更 新 的 文件 上 传 到 SVN 服务 的 仓库 中 。 
这 里 包含 两 种 检 入 方式 : 一 种 是 添加 一 个 新 的 文件 ， 另 一 种 是 更 新 一 个 变化 的 文件 。 这 两 种 
方式 的 操作 步骤 如 下 。 

(1) 进入 到 本 地 的 检 出 目录 (本 文中 为 CUsersmacy\Desktop\pasf) 。 

(2 ) 复制 或 者 新 建 一 个 文件 名 为 “wd.py” 的 文件 ， 其 内 容 如 下 。 


#!/usr/bin/env python 

# -*- coding: utf-8 -*- 

from selenium import webdriver 

from selenium.webdriver.common.alert import Alert 
from time import sleep 


wd = webdriver.Chrome () 
wd.get (r'http://www.baidu.com') 


wd.find element by id('kw') .send keys ("selenium") 
wd.find element by _ id('su').click() 

sleep (1) 

assert 'selenium' in wd.title 

wd.close() 
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(3 ) 在 检 出 目录 空白 处 右 击 ， 在 弹出 的 快捷 菜单 中 执行 “SVN 提交 ”命令 ， 如 图 9-32 
所 示 。 


(4) 在 提交 弹出 框 中 勾 选 wd.py 复 选 框 ， 并 单 击 “ 确 定 ” 按 钮 ， 如 图 9-33 所 示 。 


BooeyDekoppaf BR ToroieN Ss lo] 

提交 至 : 

httpe/ flocahost /evn /pa 
人 


CO | 


(到 册 文件 二 看 关 导 ) ; 
选中 全 部 (A) 无 (N) 无 版 本 控制 己 反 版 本 入 伸 已 幸 加 已 刚 除 己 修 改 文件 日 录 
外 扩展 名 。 状态 


经 属性 六 锁定 
] 
1 
同 寻 趟 雹 得志 近 和 和 文 件 U) 选择 了 + 个 文件 , 共有 + 个 文件 
团 从 不 网 的 瞩 本 库 叶 示 外 部 引用 们 ) 
站 供 持久 证 伯 


门生 okeasj 才 


图 9-32 “SVN 提交 …” 选 项 
(5 ) 提交 成 功 则 显示 如 下 ， 如 图 9-34 所 示 。 


图 9-33 SVN 提交 操作 


正在 发 送 内 容 。C:UsersmacyIDesktop pasfwd.py 
提交 事务 中 .… 
完毕 于 版 本 : 1 


图 9-34 ”SVN 提交 成 功 


(6) 查看 检 出 目录 中 的 wd.py 文件 ， 其 图 标 上 多 了 一 个 绿色 的 对 勾 ， 如 图 9-35 所 示 。 
〈7 ) 再 次 编辑 并 修改 wd.py 文件 ， 修 改 内 容 如 下 。 


wd.find element by id('kw').send keys ("selenium") 


wd.find element_by_id('kw'") .send_ keys("selenium hq") 


〈8 ) 此 时 wd.py 文件 图 标 中 的 绿 勾 变 成 了 红 感 叹 号 ， 如 图 9-36 所 示 。 
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图 9-35 已 同步 的 SVN 文 件 


图 9-36 已 修改 的 SVN 文 件 
(9 ) 在 检 出 目录 空白 处 右 击 ， 在 弹出 的 快捷 菜单 中 执行 “SVN 提交 ”命令 ,弹出 框 如 
图 9-37 所 示 。 


再 CNUsersynacNDesktopWpasf -提交 - TertoiseSVN 


| 
提 X 到 : 
‘http:/ /localhost/svn/past/ 


| 


要 更 列表 【双击 文件 查看 攻 异 ) : L 
选中 全 部 (A) 无 (0) 无 版 本 控制 已 经 版 本 控制 已 增加 已 删除 已 修改 文件 日 录 

路 径 扩展 名 。 状态 属性 杖 态 : 锁定 

回国 wpr oy 由 次 


灯 


《 


E29 
图 9-37 SVN 提交 

(10) 直接 单 击 “ 确 定 ” 按 钮 (提交 更 新 时 wd.py 文件 为 默认 勾 选 状态 )， 弹 出 框 如 

图 9-38 所 示 。 


》 
二 | 
选择 了 1 个 文件 ， 共 有 1 个 文件 


了 消 _ 儿 帮助 


命令 
已 修改 


提交 


C:\Wsers\macy Desktop\pasfiwd.py 


正在 发 送 内 容 。C:Wsersmacy\pesktop\pasfwd.py 


图 9-38 SVN 提交 成 功 
( 11 ) 提交 更 新 成 功 后 ， 版 本 号 将 变 为 2。 
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上 述 步 又 把 新 增 、 更 新 SVN 的 提交 过 程 都 进行 了 操作 ， 主 要 区 别 在 于 提交 新 增 文件 需 
要 主动 勾 选 ， 而 提交 修改 过 的 文件 则 是 默认 勾 选 。 此 外 ， 不论 是 新 增 还 是 更 新 SVN 内 容 ， 
SVN 仓库 的 版 本 号 都 是 会 向 上 增加 的 。 


提示 此 时 如 果 用 户 从 该 仓库 中 执行 一 次 检 出 操作 ， 那 么 新 检 出 的 目录 则 不 再 是 一 个 空 
目录 ， 目 录 里 将 会 有 最 新 版 的 wd.py 文件 被 检 出 ， 本 文中 则 是 版 本 号 为 2 的 wd.py 文件 。 


代码 更 新 : 是 指 将 SVN 服务 端 仓库 中 最 新 的 文件 变化 更 新 到 本 地 ， 使 本 地 与 SVN 服务 
端的 内 容 保持 一 致 。 这 在 多 人 协作 进行 同一 个 项 目 脚本 开发 时 有 很 重要 的 作用 ; 与 代码 检 出 
不 同 的 是 ， 代 码 更 新 只 对 SVN 库 中 有 变化 的 文件 进行 本 地 的 更 
新 ， 而 SVN 库 中 的 文件 变化 通常 是 由 其 他 开发 者 进行 代码 检 入 而 


产生 的 。 


进行 代码 更 新 操作 非常 简单 ， 只 要 在 检 出 目录 的 空白 处 右 
击 ,在 弹出 的 快捷 菜单 中 执行 “SVN 更 新 ”命令 就 可 以 完成 代码 


的 更 新 操作 ， 如 图 9-39 所 示 。 


最 后 介绍 下 代码 提交 冲突 这 个 概念 。 代 码 提交 冲突 只 有 在 多 
人 协作 同一 个 项 目 时 才 会 出 现 ， 原 因 是 同一 个 文件 的 同一 处 代码 
被 两 个 不 同 的 开发 者 分 别 进 行 了 修改 ， 这 样 SVN 程序 就 不 能 判定 


到 底 以 哪个 


需要 人 工 对 有 冲突 的 文件 进行 手 了 


后 的 代码 文件 。 


提示 ”同一 个 文件 被 不 同 的 天 


发 者 提交 的 代码 为 主 代码 。 当 提交 发 生 冲 突 时 ， 就 


[ 删 减 和 整理 ， 最 后 再 提交 整理 


撒 消 复制 (U) Ctrl+Z 
共享 (H) 


» 
这 SVN 更 新 (U) 

网 ”SVN 提交 (O- 
全 TortoiseSVN 


司 ”共享 文件 夹 同步 
新 建 (W) 
属性 (R) 


图 9-39 SVN 更 新 菜单 


Ff 发 者 分 别 进行 修改 的 情况 下 ， 如 果 被 修改 的 地 方 不 是 同一 


处 代码 ， 那 么 当 他 们 分 别提 交代 码 时 就 不 会 发 生 冲 突 ， 此 时 SVN 程序 会 自动 进行 代码 合并 。 


9.1.4 ”SVN 操作 规范 


SVN 不 仅 是 一 个 代码 管理 的 工具 ， 它 更 是 一 个 团队 协作 的 工具 ， 正 因为 此 ， 它 才 可 以 支 
持 多 人 协作 的 工作 方式 。 而 单 人 和 多 人 操作 SVN 在 流程 上 还 是 有 些 区 别 的 ， 单 人 的 情况 下 
用 户 只 有 检 出 、 检 入 两 种 操作 即 可 ， 而 多 人 的 情况 下 则 多 了 更 新 、 合 并 和 冲突 的 情况 。 


其 中 ， 代 码 冲 突 是 需要 用 户 去 手 了 


T 


[解决 的 ， 当 一 个 项 目的 代码 文件 变 的 越 来 越 多 的 时 


候 ， 如 果 有 很 多 的 冲突 需要 去 手动 解决 的 话 ， 那 么 将 会 是 一 项 很 耗 时 且 不 必要 的 工作 ; 因为 
在 解决 冲突 的 时 候 往往 也 会 很 容易 出 错 ， 所 以 在 多 人 协作 的 情况 下 ， 就 需要 对 SVN 的 操作 
流程 制定 一 个 规范 ， 从 而 最 大 限度 地 降低 代码 冲突 的 发 生 。 
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对 于 不 同 的 项 目 由 于 其 自身 需求 不 同 ， 在 SVN 操作 规范 的 细节 上 也 会 有 很 多 的 不 同 之 
处 。 例 如 ， 是 每 天 检 入 一 次 代码 ， 还 是 单个 功能 检 入 一 次 代码 。 而 大 部 分 项 目 在 SVN 操作 
的 主流 程 上 ， 基 本 还 是 保持 一 致 的 ， 这 里 就 介绍 下 通常 主流 程 的 一 些 操作 规范 。 

口 每 次 开发 新 代码 之 前 需要 先进 行 代码 更 新 操作 。 

口 提交 代码 之 前 需要 先进 行 代码 更 新 操作 。 

口 以 一 个 完整 功能 的 完成 为 阶段 提交 代码 。 

口 提交 代码 时 需要 添加 必要 的 备注 。 

这 些 规范 的 目的 主要 是 尽量 保证 本 地 文件 与 SVN 仓库 的 最 新 版 本 保持 一 致 ， 尽 可 能 地 
保持 一 定 的 代码 提交 频率 ， 以 保证 本 地 文件 的 最 新 变化 能 够 及 时 地 同步 到 SVN 仓库 ， 以 及 
能 够 通过 备注 了 解 每 次 代码 提交 时 所 做 的 变动 。 

至 此 ,关于 SVN 搭建 、 配 置 和 使 用 的 介绍 都 已 经 结束 ， 在 后 面 的 章节 里 还 会 进一步 介 
绍 如 何在 适当 的 时 候 结合 SVN 来 搭建 一 个 可 持续 集成 的 自动 化 流程 。 


提示 这 里 只 是 对 SVN 操作 的 一 些 常规 行为 说 明 ， 真 正 的 项 目 中 会 根据 不 同 的 需求 有 
不 同 的 规范 ， 例 如 ， 会 有 trunk、branch 、tag 分 支 等 。 


9.2 ”远程 执行 用 例 场景 


远程 执行 用 例 场景 是 测试 脚本 在 远程 机 器 上 进行 测试 执行 的 一 种 方式 ， 即 在 本 地 机 器 中 
对 远程 机 器 上 的 脚本 执行 进行 控制 。 这 样 我 们 在 本 机 开发 的 测试 脚本 就 可 以 在 其 他 的 机 器 上 
来 执行 ,其 目的 就 是 把 测试 脚本 的 执行 与 具体 的 机 器 进行 解 而 ， 使 得 脚本 可 以 很 方便 地 在 不 
同 的 机 器 上 无 颖 执行 ， 即 去 除 对 机 器 的 依赖 性 ， 同 时 也 对 脚本 的 兼容 性 测试 提供 很 好 的 基础 
支持 。 下 面 通过 一 张 图 解 来 简要 了 解 下 远程 执行 用 例 的 场景 流程 ， 具体 如 图 9-40 所 示 。 


El 
“EE We 


乒 丁 
代理 程序 
图 9-40 远程 脚本 执行 方式 
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图 9-40 中 的 控制 器 就 是 本 地 机 器 ， 而 代理 程序 则 是 远程 机 器 。 从 图 中 可 以 看 出 一 个 控 
制 器 可 能 会 控制 多 个 远程 机 器 来 执行 测试 脚本 ， 这 样 就 达到 一 个 分 布 式 执行 测试 脚本 的 效 
果 。 假 设 有 4 个 脚本 ， 如 果 通 过 控制 器 自己 来 执行 的 话 则 需要 执行 全 部 的 4 个 脚本 ， 而 如 果 
通过 远程 机 器 来 执行 ， 则 可 以 把 4 个 脚本 分 布 到 不 同 的 代理 程序 来 执行 。 分 布 式 执行 显 而 易 
见 的 好 处 就 是 可 以 最 大 化 利用 资源 ， 节 省 时 间 ， 提 高 测试 脚本 的 执行 效率 。 

既然 远程 执行 具有 本 地 执行 所 不 具备 的 特有 优势 ， 那 么 如 何 使 测试 脚本 能 够 支持 远程 执 
行 呢 ? 

关于 这 个 问题 如 果 使 用 的 是 其 他 的 测试 工具 ， 可 能 需要 自己 开发 分 布 式 的 测试 框架 来 支 
持 ， 如 果 使 用 本 章 中 前 面 介绍 的 Selenium 作为 测试 工具 ， 那 么 可 以 使 用 它 自 带 的 远程 执行 脚 
本 的 功能 。 具 体 而 言 ， 从 Selenium 2 开始 ，Selenium 自动 化 脚本 驱动 浏览 器 执行 测试 的 流程 
如 图 9-41 所 示 。 


计算 机 -A 


Selenium | http i 览 器 Driver| tb .| 浏览 器 


Server 


测试 脚本 


计算 机 -1 


计算 机 -2 


图 9-41 Selenium 2 驱动 浏览 器 原理 


正如 图 9-41 所 示 ，Selenium 2 驱动 浏览 器 的 方式 是 通过 浏览 器 Driver 来 实现 的 ， 而 测试 
脚本 与 Driver 之 间 是 通过 HTTP 来 进行 通信 的 ， 即 使 测试 脚本 与 driver 同时 在 一 台 机 器 上 也 
是 使 用 HTTP 网 络 通信 的 。 因 此 ，Selenium 2 生来 就 支持 测试 脚本 的 远程 执行 ， 所 以 当 我 们 
选择 了 Selenium 2 作为 测试 工具 ， 那 么 远程 执行 脚本 的 问题 自然 迎刃而解 。 

下 面 依次 介绍 在 本 地 和 远程 的 情况 下 ， 是 如 何 基于 HTTP 通信 的 方式 来 执行 测试 脚本 
的 。 默 认 情况 下 调用 本 地 浏览 器 的 测试 脚本 通常 如 代码 清单 9-1 所 示 。 


代码 清单 9-1 调用 本 地 浏览 器 


#!/usr/bin/env python 

# -*- coding: utf-8 -*- 

from selenium import webdriver 

from selenium.webdriver.common.alert import Alert 
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from time import sleep 


wd = webdriver.Ie() 
wd.get (r'http://www.baidu.com') 


wd.find element by id('kw') .send keys("selenium hq" 
wd.find element by id('su') .click() 

sleep (1) 

assert 'selenium' in wd.title 

wd.close () 


上 述 代码 中 看 不 到 使 用 过 任何 基于 HTTP 的 代码 ， 但 实际 情况 是 怎么 样 的 呢 ? 其 实在 代 
码 的 后 台 已 经 启动 了 一 个 IEDriverServer.exe 进程 ， 并 且 在 执行 结束 之 后 退出 了 该 进程 。 为 了 
重 现 这 一 场景 ， 首 先 在 本 机 找到 IEDriverServerexe 文件 所 在 位 置 ， 然 后 双击 该 文件 ， 如 图 
9-42 所 示 。 


ndows\system32\emd exe IEDriverserier oxe WWW 页 


eel = 


图 9-42 IEDriverServer 启动 界面 


图 9-42 中 的 信息 表示 启动 IEDriverServerexe 已 经 成 功 ， 并 且 正 在 监听 5555 端口 。 同 时 
在 任务 管理 器 中 也 能 查看 到 [EDriverServer.exe 进程 ， 表 示 该 进程 为 正常 启动 。 接 着 把 代码 清 
单 9-1 的 代码 进行 修改 ,具体 如 代码 清单 9-2 所 示 。 


代码 清单 9-2 基于 代码 清单 9-1 进行 修改 


#!/usr/bin/env python 

-coding: ti ~ 

from time import sleep 

from selenium.webdriver.remote import webdriver 

from selenium.webdriver.common.desired capabilities import DesiredCapabilities 


wd = webdriver.WebDriver (command executor="http://127.0.0.1:5555", 
desired capabilities=DesiredCapabilities.INTERNETEXPLORER) 
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wd.get (r'http://www.baidu.com') 


wd.find element by id('kw').send keys ("selenium hq") 
wd.find element by _ id('su').click() 

sleep (1) 

assert 'selenium' in wd.title 

wd.close () 


上 述 代码 中 只 把 原先 的 webdriver 改 成 了 remote.webdriver， 并 指定 了 图 9-42 中 的 启动 
端口 ， 这 样 测试 脚本 的 命令 就 会 直接 发 送 给 前 面 启动 的 IEDriverServerexe 进程 了 ， 然 后 该 进 
程 再 去 驱动 耻 浏览 器 ， 即 代码 清单 9-1 在 后 台所 做 的 事情 就 是 代码 清单 9-2 显 式 所 做 的 事 。 


注意 这 种 方式 启动 的 IEDriverServer.exe 进程 服务 ， 只 能 监听 本 机 的 5555 端口 。 换 句 话 
说 ， 只 有 在 本 机 执行 的 脚步 才能 与 它 进 行 通信 ， 如 果 把 脚本 复制 到 其 他 机 器 上 则 不 能 执行 。 


此 外 ,在 本 地 基于 HTTP 的 远程 执行 还 有 另 一 种 方式 ， 就 是 使 用 Selenium Server 作 代 
理 ， 具 体 做 法 就 是 先 启 动 Selenium Server 程序 ， 其 命令 如 下 。 
java -jar selenium-server-standalone-3.x.x.jar 


启动 之 后 命令 行 界面 如 图 9-43 所 示 。 


图 9-43 ”Selenium Server 启动 界面 
然后 再 启动 经 过 修改 的 本 地 测试 代码 ， 具 体 的 内 容 如 代码 清单 9-3 所 示 。 


代码 清单 9-3 ”经 过 修改 的 本 地 测试 


#!/usr/bin/env Python 
和 odings UtE-B 一 % 一 
from time import sleep 
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from selenium.webdriver.remote import webdriver 
from selenium.webdriver.common.desired capabilities import DesiredCapabilities 


wd = webdriver.WebDriver (command executor="http://127.0.0.1:4444/wd/hub", 
desired capabilities=DesiredCapabilities.INTERNETEXPLORER) 
wd.get (r'http://www.baidu.com') 


wd.find element by _ id('kw').send keys("selenium hq") 
wd.find element by id('"su').click() 

Sleep (1) 

assert 'selenium' in wd.title 

wd.close() 


代码 清单 9-3 与 代码 清单 9-2 唯 一 不 同 的 地 方 是 远程 地 址 从 原来 的 
http://127.0.0.1:5555 改 成 http://127.0.0.1:4444/wd/hub， 但 最 后 的 执行 效果 是 一 样 的 。 如 果 
希望 达到 真正 的 远程 执行 目的 ， 则 可 以 在 A 机 器 (假定 卫 为 172.16.1.10 ) 上 启动 Selenium 
Server， 并 且 在 B 机 器 (假定 卫 为 172.16.1.11 ) 上 执行 测试 脚本 即 可 ， 当 然 需 要 把 代码 9-3 
中 的 地 址 http://127.0.0.1:4444/wd/hub 修改 为 http://172.16.1.10:4444/wd/hub。 

综 上 所 述 ，Selenium 2 本 身 就 有 支持 远程 执行 脚本 的 能 力 ， 并 且 还 有 多 种 方式 可 以 支 
持 通过 HTTP 通信 进行 测试 ， 而 真正 意义 上 的 远程 执行 则 是 Selenium Server 形式 ; 但 是 
Selenium Server 的 形式 只 是 解决 了 远程 执行 脚本 的 需求 ， 对 于 需要 的 分 布 式 执行 脚本 的 需 
要 还 是 没 能 解决 。 那 么 如 何 才能 进行 分 布 式 的 执行 脚本 呢 ? 9.3 节 将 介绍 如 何 通 过 Selenium 
Grid 模块 来 实现 分 布 式 执行 测试 脚本 。 


9.3 ”Selenium Grid 模块 及 搭建 


在 前 面 的 章节 中 已 经 了 解 Selenium Grid 的 概念 ， 它 本 身 不 具有 脚本 执行 能 力 ， 可 以 把 
它 简 单 地 理解 为 网 络 中 集线器 交换 机 的 功能 ， 其 主要 作用 就 是 分 发 测试 任务 及 测试 命令 到 不 
同 的 测试 节点 ， 并 且 会 根据 具体 的 测试 脚本 需求 分 发 到 对 应 的 测试 节点 。 例 如 ， 可 以 把 测试 
Chrome 浏览 器 的 脚本 分 发 到 安装 Chrome 浏览 器 的 测试 节点 ， 把 测试 Linux 平台 的 脚本 分 发 
到 Linux 的 测试 节点 等 。 

当 使 用 Selenium Grid 之 后 ， 原 来 图 9-41 中 的 远程 驱动 流程 则 变 成 了 如 图 9-44 所 示 的 
结构 。 

图 9-44 中 PC-3、PC-Windows、PC-Linux 等 共同 组 成 了 一 个 Selenium Grid 结构 ， 其 中 ， 
PC-3 中 的 Selenium Grid 节点 仅仅 是 集线器 节点 ， 而 PC-Windows、PC-Linux 中 的 Selenium 
Server 则 是 Node 节点 。 

Hub 的 作用 是 把 测试 脚本 的 所 有 指令 都 按 要 求 分 发 到 不 同 的 Node 节点 之 上 ; 而 加 上 了 
Selenium Grid 的 好 处 就 是 所 有 测试 节点 上 的 浏览 器 终端 可 以 同时 进行 测试 ， 即 达到 了 分 布 式 
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并 行 测试 的 效果 。 接 下 来 就 介绍 下 如 何 搭建 和 使 用 Selenium Grid 来 进行 测试 。 


Chrome | LIB | Chrome 
HTTP Driver 浏览 器 
Java 脚 本 Selenium 1 LB y 
| [下 Server | HTTP | 下 Driver | “| IE 浏览 器 
PC-1 Hp HTTP 
2 HTTP Firefox | LIB | Firefox 
Sn Driver 浏览 器 
AR PC-Windows 
HTTP PC-3 7 
HTTP HTTP ,| Chrome | LIB,| Chrome 
Python 脚本 Driver 浏览 器 
Selenium 
PC-2 
Server Firefox | LIB | Firefox 
HTTP | Driver 浏览 器 
Na PC-Linux 
Selenium | _HTTP__| phantomJS 
Server 浏览 器 
PC- 其 他 操作 系统 


图 9-44 Selenium Grid 工作 流程 


9.3.1 Selenium Grid 环境 搭建 


Selenium Grid 是 一 个 网 格 架构 的 统称 ， 其 主要 是 由 一 个 Hub 与 多 个 Node 节点 共同 组 成 
的 一 个 网 络 网 格 结构 ， 所 以 需要 分 别 启动 Hub (集线器 ) 和 Node (节点 ) 才能 使 用 ; 由 于 其 
代码 已 经 包含 在 selenium-server-standalone-3.x.x.jar 包 中 ， 因 此 不 需要 额外 下 载 启动 包 ， 直 接 
使 用 下 面 的 命令 就 可 以 启动 Selenium Hub 节点 。 

java -jar selenium-server-standalone-3.x.x.jar -role hub 

启动 后 在 命令 行 的 显示 内 容 如 图 9-45 所 示 。 

图 中 有 两 处 加 框 标记 ， 一 处 为 0.0.0.0:4444， 表 示 所 有 外 部 卫 都 可 以 通过 4444 端口 来 发 
送 测试 指令 ; 另 一 处 为 http://192.168.0.104:4444/grid/register， 表 示 Selenium Server 节点 需要 
通过 这 个 URL 来 注册 到 Hub 上 ， 注 册 后 Selenium Hub 才能 把 接收 到 的 指令 转发 给 具体 的 测 
试 节 点 ， 其 中 ，192.168.0.104 为 Selenium Hub 所 在 机 器 的 人 P。 
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接 下 来 还 需要 启动 Selenium Server 作为 Node 节点 ， 与 之 前 单独 启动 Selenium Server 命 
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丽 jav。-jar selenium-server-standalone-3.3.1jar -role hub 


.selenium 
ild info 
iun Grid hub 
ng initialized @652ins to org 


Hh 
-Se o 
2 下 
ee17-84-22 14 :INFO:0sjsh.ContextHandler: letC 


7: INFO FDST es 
INFO - Nodes should res ; 9 44/grid/ regi 


eniun Grid hub is up and running 


图 9-45 ”Selenium Grid 启动 界面 


令 相 比 多 了 一 些 参数 ， 具 体 的 命令 内 容 如 下 。 


java -jar selenium-server-standalone-3.x.x.jar -role node 

其 中 的 $fur} 需 要 替换 成 启动 Selenium Hub 时 回 显 的 注册 URL， 在 本 文中 为 
http://192.168.0.104:4444/grid/register， 而 如 果 Node 与 Hub 是 在 同一 台 机 器 启动 的 ， 则 URL 
可 以 是 http:Wlocalhost:4444/grid/register， 并 且 这 也 是 它 的 默认 值 ; 在 执行 后 命令 行 显示 内 容 
如 图 9-46 所 示 。 


aunching a 


3: INPO: :nain 


ty9 util.1og.S 
15:46 .945 INFO not found 


on this nachine. 


952 INFO - Driver provider org.openqa.seleniun.safari.$. 
ion is skipped: 
tion capabilities Capabilities [CbrowserNane=sa : ion=, platforn 
not natch the current 
INFO:0sjs 
ruleto| 


erConnecto| 
TTP/A .1, [http/1 .11 
:INE 
eleniun Grid node is up 
Starting auto registration thread. Will 


Registering the node to the hub: http://localhost:4444/grid 


FO -| The node is red to the hub and ready to use 
SESSIONCTSSTE QTNTEFTTRSIIEEE Hedut 9 and c 


图 9-46 Selenium Node 注册 


-hub ${url} 
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从 图 9-46 中 可 以 看 出 ，Node 已 经 成 功 注册 到 Hub 上 ， 此 时 可 以 通过 Selenium Grid 提 
供 的 一 个 在 线 接口 来 查看 Hub 及 Node 的 相关 状态 。 打 开 浏 览 器 并 在 地 址 栏 中 输入 http:/ 
localhost:4444/grid/console， 就 可 以 查看 相关 状态 信息 。 具 体 页 面 内 容 如 图 9-47 所 示 。 


re 
Se Grid Console v.3.3.1 


DefaultRemoteproxy (version : 3.3.1) 
id : http://192.168.0.104:5555, OS : VISTA 


Browsers 【ee 


WebDriver 


v: 茵 回回 回回 
veeeee 


Config for the hub : 
browserTimeout : 0 

debug : false 

help : false 

port : 4444 

role : hub 

timeout : 1800 

cleanUpCycle : 5000 

host : 192.168.0.104 
capabilityMatcher : org.openqa.grid.internal.utils.DefaultCapabilityMatcher 
newSessionWaitTimeout : -1 
throwOnCapabilityNotpresent : true 
Config details : 


9-47 ”Selenium Grid 信息 查看 


图 9-47 中 可 以 看 到 Hub 的 状态 及 注册 Node 的 节点 信息 ， 这 里 在 注册 Node 节点 时 使 用 
的 是 默认 参数 来 配置 浏览 器 及 平台 ， 从 图 中 可 以 看 出 一 台 Windows 机 器 在 默认 情况 下 会 注册 
5 个 Firefox 节点 、1 个 下 节点 、5 个 Chrome 节点 。 

如 果 测 试 机 器 上 只 有 正 浏览 器 时 ， 那 么 在 注册 Node 节点 时 则 需要 特别 地 指定 浏览 器 类 
型 ， 具 体 的 注册 命令 如 下 。 


java -jar selenium-server-standalone-3.3.1.jar -role node -capabilities 
browserName="internet explorer",maxInstances=1 


此 外 ，capabilities 参数 还 可 以 指定 平台 类 型 具体 参数 和 部 分 可 选 值 如 下 。 

口 browserName: 可 选 值 有 internet explorer、firefox、chrome、safari、opera 等 。 

口 platform: 可 选 值 有 VISTA、LINUX、MAC， 默 认 根据 执行 平台 决定 。 

口 maxInstances: 可 选 值 为 数字 1 一 2， 其 中 , 为 Hub 启动 时 设置 的 最 大 Session 数量 ， 

默认 是 5。 

口 seleniumProtocol: 默认 值 为 WebDriver。 

如 果 需 要 同时 指定 多 个 浏览 器 ,那么 可 以 使 用 多 个 capabilities 参数 ， 每 一 个 capabilities 
参数 后 面 跟 具体 的 配置 节点 信息 即 可 。 
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9.3.2 Selenium Grid 使 用 


在 Selenium Grid 架构 启动 完毕 之 后 就 可 以 使 用 Selenium Grid 进行 分 布 式 测试 ， 具 体 如 


代码 清单 9-4 所 示 。 


代码 清单 9-4 ”使 用 Selenium Grid 进行 分 布 式 测试 


#!/usr/bin/env Python 

# ~- coding: utf-8 -*~ 

from time import sleep 

from selenium.webdriver.remote import webdriver 


from selenium.webdriver.common.desired capabilities import DesiredCapabilities 


wd = webdriver.WebDriver( 
command executor="http://127.0.0.1:4444/wd/hub", 
desired capabilities=DesiredCapabilities.INTERNETEXPLORER) 
wd.get (r'http://www.baidu.com') 
wd.find element by id('kw').send keys("selenium hq") 
wd.find element_by_id('su').click() 
sleep(1) 
assert 'selenium' in wd.title 
wd.close() 


上 述 代码 只 能 在 启动 Hub 的 机 器 上 执行 ， 如 果 在 需要 Hub 之 外 的 机 器 上 执行 ， 则 需要 


修改 Hub 地 址 中 的 127.0.0.1 为 Hub 机 器 的 外 部 访问 地 址 ， 本 节 中 为 192.168.0.104。 


提示 。 如果 测试 脚本 比较 多 ,需要 使 用 分 布 式 执行 来 加 快 执行 速度 ， 那 么 需要 启动 多 
个 执行 脚本 的 客户 端 进程 ， 或 者 直接 使 用 单元 测试 框架 支持 的 并 行 执行 功能 。 另 外 ， 如 果 测 
试 机 器 资源 不 够 ， 也 可 以 考虑 使 用 Docker 容器 技术 。 目 前 Selenium 官方 有 Grid、Chrome、 
Firefox、Phantomjs 节点 的 Docker 镜像 可 以 使 用 ， 具 体 可 以 查看 GitHub 项 目 主页 https:/ 
github.com/SeleniumHQ/docker-selenium 。 


9.4 持续 集成 的 自动 化 测试 


化 测试 流程 集成 到 整个 项 目 开发 的 流程 中 ， 即 在 任何 需要 启动 自动 化 测试 的 时 间 点 ， 可 以 


当 可 以 稳定 、 高 效 地 在 不 同 平台 和 浏览 器 上 运行 测试 脚本 之 后 ， 还 可 以 做 的 就 是 把 自 


颖 地 切 和 人 自动 化 测试 流程 中 。 例 如 ， 作 为 敏捷 测试 每 天 都 会 有 一 个 daily build， 那 么 在 每 
构建 完成 之 后 就 可 以 启动 对 应 的 单元 测试 、 自 动 化 的 冒 烟 测试 等 。 这 就 是 一 个 持续 跟 进 的 
目 集成 的 自动 化 测试 ， 本 节 介 绍 如 何 把 测试 嵌入 到 持续 集成 流程 之 中 。 


动 
无 
天 
项 
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持续 集成 已 经 是 一 个 很 熟悉 甚至 是 很 流行 的 名 词 ， 它 主要 指 的 是 持续 频繁 地 对 代码 进行 
集成 和 构建 的 过 程 。 由 于 是 频繁 构建 代码 (一 天 至 少 一 次 )， 所 以 每 一 次 构建 完成 之 后 就 需要 
有 对 应 的 自动 化 测试 来 支持 ， 否 则 测试 人 员 无 法 跟 上 开发 的 提交 频率 。 而 我 们 的 UI 自动 化 
测试 由 于 测试 用 例 数量 、 测 试 效率 、 测 试 资源 等 ， 通 常 不 会 频繁 地 被 触发 ， 但 会 在 每 日 构建 
之 后 触发 。 

持续 集成 定义 的 是 一 个 代码 提交 、 评 审 、 编 译 、 构 建 、 交 付 、 部 署 等 一 系列 操作 的 过 
程 ， 具 体 到 每 一 个 团队 、 每 一 个 项 目 其 细节 方面 会 根据 需求 来 进行 选择 和 定制 ;而 在 这 整个 
过 程 中 与 UI 自动 化 相关 的 则 是 构建 过 程 ， 因 为 在 构建 之 后 就 会 触发 自动 化 测试 脚本 。 那 么 
UI 自动 化 测试 是 如 何 接 人 到 构建 流程 之 中 呢 ? 

首先 ， 得 有 一 个 可 以 自动 化 构建 的 流程 ， 在 这 方面 有 很 多 优秀 的 开源 构建 工具 可 以 选 
择 ， 例 如 ，Jenkins、CruiseControl 等 。 本 文中 就 以 Jenkins 为 例 讲 解 如 何 部 署 和 配置 自动 化 
测试 脚本 到 持续 集成 的 过 程 中 。 

其 次 ， 需 要 让 自动 化 测试 脚本 有 一 个 启动 的 命令 ， 通 过 调用 这 个 命令 来 启动 对 应 测试 
集 的 自动 化 测试 ， 这 样 就 可 以 通过 Jenkins 的 脚本 来 远程 调用 这 个 启动 命令 。 关 于 测试 脚 
本 的 启动 命令 可 以 参见 单元 测试 章节 ， 通 过 单元 测试 集 的 功能 来 动态 加 载 对 应 的 测试 用 例 
即 可 。 

最 后 ， 需 要 在 Jenkins 上 来 配置 如 何 启动 远程 调用 测试 命令 ， 具 体 的 Jenkins 工具 上 的 配 
置 步 又 如 下 。 

(1 ) 下 载 并 完成 Jenkins 的 安装 与 配置 。 

(2 ) 浏览 访问 Jenkins 主页 。 

(3 ) 单 击 “ 新 建 任务 ”并 进入 页 面 ， 如 图 9-48 所 示 。 


Enter an item name 


auto testing 


» Required field 


构建 一 个 自由 风格 的 软件 项 目 


三 这 是 Jenkins 的 主要 功能 Jenkins 将 会 结合 任何 SCM 和 任何 构建 系统 来 构建 你 的 项 目 , 其 至 可 以 构建 软件 以 外 的 系统 


Pipeline 
更 Orchestrates long-running activities that can span multiple build slaves Suitable for building pipelines (formerly kn| 
organizing complex activities that do not easily fit in free-style job type. 


External Job 


© This type of job allows you to record the execution of a process run outside Jenkins, even on a remote machine | 
一 ”can use Jenkins as a dashboard of your existing automation system 


图 9-48 ”新建 Jenkins 任务 
(4) 输入 任务 名 并 选择 构建 一 个 自由 风格 的 软件 项 目 ， 如 图 9-49 所 示 。 
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图 9-49 Jenkins 任务 仓库 设置 
(5 ) 选择 使 用 Subversion 进行 源码 管理 ， 并 填写 相关 的 SVN 地 址 与 账户 ， 如 图 9-50 所 示 。 


Sooooeos 


pu aat have nn 对 2017 和 4 本 册 昌 下 08115 全 156 CST wouid ned nn at 2017 征 4 有 2 日 旺 则 下 401 
M2510l CST 


图 9-50 Jenkins 任务 执行 时 间 设 置 
(6 ) 构建 触发 器 选择 Poll SCM， 并 设置 每 10 分 钟 进行 一 次 SVN 代码 检测 ， 如 果 有 新 代 
码 被 提交 了 则 触发 构建 。 
(7 ) 构建 选项 默认 设置 为 使 用 Maven 进行 代码 构建 。 
(8 ) 添加 一 个 Windows 脚本 构建 命令 ， 并 填写 自动 化 脚本 的 触发 命令 ， 如 图 9-51 所 示 。 


构建 
toot 6 
站 | 男 。 
可 - 
回 。 
参阅 可 用 环 二 灾 重 F = 
ER 


图 9-51 Jenkins 任务 脚本 设置 
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(9 ) 保存 该 构建 并 回 到 项 目 首页 ， 如 图 9-52 所 示 。 


Jenkins » autotesting » 
会 返回 面板 
project puto testing] 
Q 基态 
基 # 改 记录 
工作 空间 
本 
© Ws Project 
三 最新 收 改 记录 
闪 三 Et 
转 subversion Pomng Log 
相关 连接 
Build History 构建 历史 一 
find 
国 RSS 全 部 国 RSS 失败 


图 9-52 Jenkins 任务 构建 
(10 ) 通过 单 击 “立即 构建 ”可 以 测试 所 配置 的 构建 流程 。 


提示 在 第 8 步 中 填写 start auto_testing.bat 文件 ， 是 需要 提前 在 Jenkins 服务 器 上 创建 
并 编写 启动 命令 的 ; 如 果 脚 本 在 本 地 就 可 以 使 用 Python 命令 启动 单元 测试 入 口 文件 ， 而 如 
果 脚 本 在 远程 机 器 上 则 可 以 通过 远程 命令 工具 (如 putty、ssh) 来 执行 远程 机 器 上 的 Python 
命令 。 


CHAPTER 


10 第 10 章 
Web API 介绍 


Web 自动 化 测试 通常 被 特 指 为 Web 的 UI 自动 化 测试 ， 而 其 实 Web 的 API 自动 化 测试 
也 是 包含 在 内 的 ; 关于 针对 API( 即 接口 ) 的 自动 化 测试 在 前 面 的 章节 中 已 经 了 解 过 了 ， 它 
相对 于 UI 自动 化 测试 来 说 ， 虽 然 不 能 模拟 真实 用 户 的 场景 操作 ， 但 是 其 在 投资 回报 率 上 却 
比 UI 自动 化 高 很 多 ; 所 以 当 项 目 需要 考虑 实施 自动 化 测试 的 时 候 ， 可 以 结合 不 同 自动 化 测 
试 的 特性 来 配合 使 用 。 

本 章 先 带 读者 来 认识 下 具体 的 Web API 的 一 些 情况 ， 接 下 来 的 章节 将 会 继续 介绍 如 何 去 
调用 和 测试 Web API。 


10.1 HTTP 简介 


对 于 一 名 Web 测试 人 员 来 说 ， 尤 其 是 Web 的 自动 化 测试 人 员 ，HTTP 是 必须 需要 理解 和 
掌握 的 ; 因为 不 论 是 Web 页 面 也 好 ，Web API 也罢， 它们 都 是 基于 HTTP 之 上 进行 通信 的 ， 所 
以 本 节 先 认识 下 HTTP 的 一 些 基 本 概念 ， 而 对 于 已 经 掌握 的 读者 则 可 以 直接 阅读 后 面 的 章节 。 

HTTP 全 称 为 超 文 本 传输 协议 (HyperText Transfer Protocol)， 是 互联 网 上 应 用 最 为 广泛 
的 一 种 网 络 协议 。 它 是 一 个 客户 端 和 服务 器 端 请 求 和 应 答 的 标准 ; 客户 端 是 终端 用 户 ， 服 务 
器 端 是 网 站 。 用 户 可 以 通过 浏览 器 、 爬 虫 工具 等 对 服务 器 网 站 进行 访问 。 

HTTP 是 一 种 基于 TCP/IP 之 上 的 传输 协议 ， 其 通信 流程 总 是 由 客户 端 发 起 ， 再 由 服务 器 
端 进行 处 理 和 响应 ; 并 且 每 次 收 到 服务 器 的 响应 之 后 都 会 立即 关闭 当 次 连接 ， 正 是 由 于 每 次 
请 求 都 会 发 起 一 个 新 的 连接 ， 所 以 HTTP 是 一 种 无 状态 协议 ， 即 服务 器 端 不 能 保存 客户 端的 
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状态 信息 。 

关于 HTTP 的 具体 内 容 在 RFC2616 中 进行 了 详细 的 说 明 ， 而 这 里 把 HTTP 分 为 两 部 分 
进行 说 明 ， 一 部 分 是 浏览 器 发 送 的 请 求 报 文 ， 另 一 部 分 为 服务 器 的 响应 报 文 。 具 体 每 一 部 分 
的 格式 和 包含 内 容 下 面 将 分 别 进行 一 个 简单 介绍 。 


10.1.1 HTTP 请 求 报 文 


HTTP 请 求 报 文 指 的 是 客户 端 向 服务 器 端 发 送 请 求 时 所 传输 的 内 容 ; 该 内 容 是 由 固定 
格式 组 成 的 ， 具体 来 说 ，HTTP 请 求 报 文 由 请 求 行 、 请 求 头 和 请 求 体 组 成 。 其 结构 内 容 如 图 
10-1 所 示 。 


HTTP 请 求 格式 
请 求 行 | 请 求 方法 ”| 空格 | 请 求 地 址 ”| 空格 | 协议 版 本 |\r\n 
headerl 图 | valuel \r\n 
header2 Value2 \r\n 


请 求 头 | header3 value3 \r\n 


header... 和 : \r\n 
headerN |: | valueN \r\n 
罕 行 | \rn 
请 求 体 请 求 体 


图 10-1 HTTP 请 求 头 格式 

请 求 行 部 分 由 请 求 方法 、 请 求 URL 地 址 及 参数 、 请 求 协 议 以 空格 隔 开 共 同 组 成 。 其 中 ， 
请 求 方法 包括 GET、POST、PUT、DELETE、PATCH、HEAD、OPTIONS、TRACE。 最 常 
见 的 两 种 是 GET 和 POST， 如 果 是 RESTful 接口 的 话 一 般 会 用 到 GET、POST、DELETE、 
PUT。 请求 协议 有 HTTP 1.0 和 HTTP 1.1。 具 体 的 请 求 行内 容 如 以 下 示例 。 

GET /helloWorld HTTP/1.1 

请 求 头 部 分 是 由 一 组 或 多 组 键 值 对 组 成 的 ， 请 求 头 所 支持 的 键 值 对 内 容 具 体 可 以 参考 
http://tools.jb51.net/table/http_header 页 面 中 的 说 明 。 一 般 情 况 下 的 请 求 头 内 容 如 代码 清单 
10-1 所 示 。 


代码 清单 10-1 请求 头 内 容 


Accept :image/gif.image/jpeg,*/* 

Accept-Language:zh-cn 

Connection:Keep-Alive 

Host:localhost 

User-Agent :Mozila/4.0 (compatible;MSIES5.01;Window NT5.0) 
Accept-Encoding:gzip, deflate 


请 求 体 是 专门 用 来 存放 向 服务 器 传输 的 数据 ， 尤 其 是 大 批量 的 数据 提交 必须 要 通过 请 求 
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体 进行 传输 。 此 外 ， 只 有 POST、PUT 以 及 PATCH 三 种 请 求 方法 支持 请 求 体 ， 而 其 他 的 请 求 
方法 都 不 带 请 求 体 。 

请 求 体内 容 本 身 还 可 以 划分 成 三 大 类 : Query String， 文件 分 割 ， 其 他 类 型 。 其 中 ， 
Query String 指 的 是 application/x-www-form-urlencoded 类 型 的 请 求 体 ， 这 是 Form 表单 提交 
时 的 默认 数据 类 型 ， 其 内 容 是 由 K、V 对 连接 串联 组 成 的 ， 具体 可 以 参见 图 10-2 中 的 请 求 体 。 


HTTP 请 求 格式 


| | | | | 
请 求 行 | 请 求 方法 “| 空格 | 请 求 地 址 | 空格 | 协议 版 本 | mm 
| headerl |: |valuel | rn 
| header2 |: value2 | em 
请 求 头 | Contet-Type | : application/x-www-form-urlencoded | Nm 


| header... |: : | rn 
| headerN Ls valueN | em 
空 行 | wn 


请 求 体 


keyl=valuel&key2=value2 
图 10-2 HTTP 请 求 头 格式 2 
文件 分 割 类 型 的 请 求 体 是 专门 用 来 进行 文件 上 传 的 ， 它 由 多 个 部 分 组 成 ， 每 一 个 部 分 都 
被 boundary 分 割 成 单独 的 段 ， 这 个 boundary 是 在 请 求 头 的 Content-Type 中 指定 的 。 具 体 的 
结构 如 图 10-3 所 示 。 


HTTP 请 求 格式 

请 求 行 | 请 求 方法 _ | 空格 请 求 地 址 | 空格 | 协议 版 本 | rn 
headerl valuel Yn 

请 求 头 header2 Value2 \rn 
Contet-Type | : multipart/form-data;boundary={boundary} | \rin 
header... H : \rn 
headerN - valueN rn 

空 行 |\rm \rn 
--{boundary} Am 

请 Contet- 

人 Disposition | : from-data;name="name" An 
Nm Nm 
小 老虎 \rn 
--{boundary} Am 

请 求 体 CR、 : from-data;name="file";filename="testtxt" | \r\n 
Disposition 了 

part2 Contet-Type | : application/octet-stream \rn 
Nm Nm 
文件 二 进 制 内 容 An 

请 求 体 

结束 |--{boundary}-- Am 

标识 


图 10-3 HTTP 请 求 格式 3 


第 10 章 Web API 介 绍 & 239 


其 他 类 型 的 请 求 体 是 指 Query String 和 文件 分 隔 类 型 以 外 的 类 型 ， 请 求 体内 容 的 格式 可 
以 自 定 义 ， 最 常见 的 格式 有 application/json、text/xml 等 。 
最 后 来 看 一 个 完整 的 POST 请 求 报 文 的 内 容 实例 ， 如 图 10-4 所 示 。 


入 大 人 URL 大 HTTP 及 版 本 


POST /chapter17/user. html HTTP/1.1 


@rAccept: image/jpeg, application/x-ms-application, ..., +*/* 
报 |Referer: http://localhost:8088/chapterl7/user/register. html? 
文 | code=100&time=123123 

头 |Accept-Language: zh-CN 


User-Agent: Mozilla/4.0 (compatible; MSIE 8.0; Windows NT 6.1; 
Content-Type: application/x-www-form-urlencoded 

Host: localhost:8088 

Content-Length: 112 

Connection: Kec liye 

Cache-Control: no-cach 

Cookie: JSESSIONID= 24DF2688E37EE4F66D9669D2542AC17B 


一齐 闪 渤 @ 


name=tom&password=1234&realName=tomson 


图 10-4 HTTP 请 求 报 文 


10.1.2 ”HTTP 响应 报 文 


HTTP 响应 报 文 是 服务 器 端 发 送 给 客户 端的 响应 内 容 。 其 格式 与 请 求 报 文大 致 相同 ， 主 
要 由 响应 行 、 响 应 头 和 响应 体 组 成 。 其 结构 如 图 10-5 所 示 。 


HTTP 响 应 格式 
| | 
响应 行 | 协议 版 本 | 空格 | 状态 码 | 空格 | 状态 描述 | em 
headerl > valuel | em 
header2 value2 \rn 
响应 头 | header3 value3 Am 
header... 3 | mm 
headerN valueN | en 
空 行 | en 
响应 体 响应 体 
图 10-5 HTTP 响应 格式 


响应 行 包括 协议 版 本 、 状 态 码 和 状态 描述 三 部 分 。 协 议 版 本 与 请 求 行 保持 一 致 ， 状 态 
码 与 状态 描述 是 服务 器 处 理 完 请 求 后 的 反馈 信息 。 其 中 ， 状 态 码 可 以 分 为 5 类 ， 具体 如 下 
所 示 。 

口 1xx: 消息 , 一 般 是 告诉 客户 端 ， 请 求 已 经 收 到 了 ， 正 在 处 理 ， 别 急 。 

口 2xx : 处 理 成 功 ,一 般 表示 请 求 收 悉 、 我 明白 你 要 的 、 请 求 已 受理 、 已 经 处 理 完成 等 
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信息 。 

口 3xx: 重 定向 到 其 他 地 方 。 它 让 客户 端 再 发 起 一 个 请 求 以 完成 整个 处 理 。 

口 4xx : 处 理发 生 错 误 ， 责 任 在 客户 端 ， 如 客户 端 请 求 一 个 不 存在 的 资源 、 客 户 端 未 被 

授权 、 禁 止 访问 等 。 

口 5xx : 处 理发 生 错 误 ， 责任 在 服务 端 ， 如 服务 端 抛 出 异常 、 路 由 出 错 、HTTP 版 本 不 

支持 等 。 

上 面 的 每 一 类 中 又 有 很 多 值 可 选 ， 例 如 ，200 表示 服务 器 正常 处 理 请 求 并 返回 结果 ，404 
表示 请 求 的 资源 不 存在 ; 具体 每 一 个 状态 码 的 详解 可 以 参考 http://tools.jb51.net/table/http_ 
status_code 页 面 中 的 说 明 。 

响应 头 与 请 求 头 格 式 一 致 ， 只 是 使 用 的 头 信息 内 容 不 一 样 而 已 。 响 应 体 就 是 服务 器 返回 
给 客户 端的 具体 内 容 了 ， 通 常 分 为 两 类 : 一 类 是 用 于 浏览 器 解析 HTML 页 面 内 容 ， 一 类 是 数 
据 内 容 。 

最 后 来 看 一 个 完整 的 响应 报 文 的 内 容 实例 ， 如 图 10-6 所 示 。 


@D 报 文 协 。@ 状 态 码 及 
议 及 版 本 状态 描述 


一 和 一 
HTTP/1.1 200 OK 
-| Server: Apache-Coyote/1.1 
Content-Type: application/json 
Transfer-Encoding: chunked 
一 | Date: Mon, 12 Sep 2011 12:41:24 GMT 
门 6f 
{"password":"1234","userName":"tom","birthday":null,"salary":0, 
"realName":"tomson","userId":"1000","dept":null} 
0 


袜 同 量 人 © ”同盟 @ 


图 10-6 HTTP 响应 报 文 


10.2 Web API 介绍 


Web API 是 网 络 应 用 程序 接口 。 这 类 API 是 在 Web 服务 器 端 提 供 ， 并且 是 通过 HTTP 来 
访问 的 ; 通过 这 些 API 可 以 获得 各 种 类 型 的 数据 服务 , 例如， 存储 服 务 、 计 算 服务 等 。10.1 
节 中 提 到 Web 服务 器 的 响应 体格 式 有 两 种 ， 一 种 是 HTML 内 容 ， 另 一 种 是 非 HTML 的 数据 
内 容 ，Web API 的 响应 体 就 是 属于 第 二 种 。 

可 以 把 Web API 理解 为 Web 上 的 API， 而 访问 它 的 方式 就 是 通过 HTTP 请 求 来 实现 的 ; 
并 且 Web API 是 特 指 那些 能 够 提供 完整 服务 的 接口 ， 所 以 并 不 是 任意 的 一 个 URL 地 址 都 可 
以 认为 是 Web API。 例 如 ，http://www.baidu.com 就 不 是 Web API， 因 为 它 只 返回 了 固定 的 
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HTML 内 容 ， 而 http://apis.baidu.com/kuaidicom/express_api/express_api 则 是 Web APTI， 
它 可 以 根据 不 同 的 快递 单 号 来 查询 对 应 的 快递 信息 。 
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因为 


总 结 来 说 ，Web API 就 是 拥有 特定 功能 的 网 络 接口 ， 更 具象 地 讲 就 是 可 以 提供 某 种 服务 


的 URI 地 址 。 


10.3 ”REST API 介绍 


前 面 讲 到 的 Web API 是 HTTP 服务 中 的 一 种 ， 而 本 节 中 的 REST API 则 是 Web API 中 的 
一 种 。REST API 不 仅 能 提供 完整 的 Web API 服务 ， 并 且 在 其 请 求 设计 上 有 自己 的 约束 条 件 
和 原则 。 我 们 可 以 把 REST API 理解 为 一 套 互联 网 应 用 程序 的 API 设计 理论 ， 通 过 这 套 设 计 
理论 而 开发 出 来 的 Web API 就 是 REST API 了 。 接 下 来 就 介绍 下 REST API 具体 有 哪些 设计 


规范 和 要 求 。 
口 通信 协议 : 总 是 HTTPS。 
口 域名 : 尽量 放 在 专用 域名 下 ， 如 http://api.example.cn, http://example.cn/api/ 等 。 


口 版 本 : 应 将 API 版 本 号 放 在 URL 中 ， 如 http:/api.example.cn/vl/， 也 有 把 版 本 号 放 在 
Header 中 的 。 

口 路 径 : 即 API 的 具体 网 址 ， 在 RESTful 中 每 一 个 网 址 代表 一 种 资源 ， 所 以 网 址 中 不 能 
有 动词 ， 只 能 有 名 词 ; 并 且 网 址 应 该 比较 有 意义 和 目的 性 ， 如 果 是 集合 的 话 需要 用 复 
数 形式 ， 如 http://api.example.com/vl/employees。 

口 动 词 : 即 具 体 的 操作 类 型 ， 如 GET、POST、PUT、DELETE、PATCH 等 。 在 请 求 时 
不 同 的 操作 类 型 代表 不 同 的 意思 ， 具 体 如 下 。 
> GET /zoos: 列 出 所 有 动物 园 。 
> POST /zoos: 新 建 一 个 动物 园 。 
> GET /zoos/ID: 获取 某 个 指定 动物 园 的 信息 。 
> PUT /zoos/ID: 更 新 某 个 指定 动物 园 的 全 部 信息 。 
> PATCH /zoos/ID: 更 新 某 个 指定 动物 园 的 部 分 信息 。 
> DELETE /zoos/ID: 删除 某 个 动物 园 。 

口 过 滤 信息 : 提供 可 以 对 返回 结果 进行 过 滤 的 参数 ， 如 : ?limit=20。 

口 状态 码 : 服务 器 向 客户 端 返回 的 状态 码 和 提示 信息 ， 例 如 ,200 OK 表示 获取 信息 成 功 ， 
201 CREATED 表示 创建 或 更 新 成 功 。 

口 错误 处 理 : 如 果 状 态 码 是 4xx， 就 应 该 向 用 户 返 回 出 错 信息 ， 通 常 以 error 为 key; 如 : 
{error: "Invalid API key"} 。 

口 返回 结果 : 针对 不 同 操作 ， 服 务 器 向 用 户 返 回 的 结果 应 该 符合 以 下 规范 。 
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> GET /collection: 返回 资源 对 象 的 列表 (数组 )。 
> GET /collection/resource: 返回 单个 资源 对 象 。 
> POST /collection: 返回 新 生成 的 资源 对 象 。 
> PUT /collection/resource: 返回 完整 的 资源 对 象 。 
> PATCH /collection/resource: 返回 完整 的 资源 对 象 。 
> DELETE /collection/resource: 返回 一 个 空 文档 。 
口 Hypermedia API: 即 请 求 API 根 目录 时 返回 的 请 求 文档 ， 该 文档 相当 于 一 个 用 户 手册 ， 
列 出 了 该 RESTful 架构 中 所 有 可 用 的 API 链接 和 相关 请 求 说 明 。 例 如 ， 访 问 https:// 
api.github.com/ 可 以 得 到 如 下 代码 。 


"current user url": "https://api.github.com/user", 
"authorizations url": "https://api.github.com/authorizations", 
//... 
} 
口 其 他 : API 的 身份 认证 应 该 使 用 OAuth 2.0 框架。 服务 器 返回 的 数据 格式 通常 为 
JSON。 


总 而 言 之 ，REST API 就 是 在 设计 上 符合 上 述 规范 的 Web API， 或 者 说 符合 上 述 设计 规 
范 的 能 够 提供 完整 服务 的 URI 网 络 资源 。 


CHAPTER 
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第 10 章 介 绍 了 Web API 的 一 些 相关 概念 ， 可 以 说 Web API 也 是 进行 Web 自动 化 测试 的 
一 个 重要 对 象 ; 它 是 在 Web UI 测试 前 一 阶段 的 测试 ， 属 于 我 们 在 第 3 章 里 提 到 的 倒 三 角 模 
型 中 的 集成 测试 部 分 ; 对 于 这 类 测试 不 需要 跟 UI 打交道 ， 而 是 直接 调用 API， 最 后 对 接口 返 
回 的 数据 进行 验证 即 可 。 

由 于 接口 类 测试 都 需要 在 测试 前 准备 数据 、 测 试 后 验证 数据 ， 因 此 对 于 一 些 常 规 数据 文 
件 的 处 理 技能 ， 需 要 在 进行 接口 测试 之 前 就 掌握 好 。 而 本 章 主要 介绍 Web API 测 试 所 需要 掌 
握 的 一 些 数 据 处 理 模块 。 


11.1 正则 表达 式 模块 学 习 


正则 表达 式 ， 又 称 规则 表达 式 (Regular Expression，RE)， 是 计算 机 科学 的 一 个 概念 ， 它 
描述 了 一 种 字符 串 匹 配 的 模式 ， 通 过 这 个 模式 可 以 对 字符 串 进行 搜索 、 匹 配 和 替换 等 操作 。 
通常 情况 下 对 某 个 字符 串 进 行 搜索 时 ， 使 用 的 可 能 是 一 个 固定 的 子 字符 串 。 例 如 ， 在 字 
符 串 “ Hello world ! ”中 搜索 子 字符 串 “ Hello”。 如 果 要 进行 搜索 的 内 容 不 固定 ， 例 如 ， 搜 
索 以 “He” 开 头 的 单词 ， 则 无 法 通过 普通 方式 进行 字符 串 搜索 ， 而 这 正 是 正则 表达 式 所 要 解 
决 的 场景 。 
正则 表达 式 之 所 以 能 对 不 固定 的 内 容 进行 搜索 ， 是 因为 它 提出 了 一 种 模式 的 概念 ; 这 
个 模式 有 它 特 定 的 语法 形式 ， 在 这 个 语法 里 规定 了 特定 的 字符 来 代表 指定 的 字符 范围 ， 例 


令 
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如 ，"d' 就 代表 了 一 个 任意 的 数字 ， 其 可 以 代替 0 ~ 9 中 的 任意 一 个 数字 ; 同时 语法 中 还 规定 
匹配 数量 、 匹 配 开 头 、 匹 配 结尾 、 匹 配 排除 等 功能 的 描述 。 关 于 正则 表达 式 的 具体 语法 形式 
学 习 请 参考 http://www.runoob.com/regexp/regexp-tutorial.html。 


在 Web API 自动 化 测试 中 ， 最 重要 的 一 个 环节 就 是 对 接口 返回 数据 进行 验证 ; 由 于 返回 


的 数据 可 能 是 各 种 各 样 的 内 容 ， 而 需要 验证 的 内 容 也 可 能 是 各 种 形式 的 ， 因 此 就 需要 一 种 很 
强 的 字符 内 容 检索 工具 来 实现 验证 的 功能 ， 而 正则 表达 式 就 是 不 二 之 选 。 接 下 来 就 来 介绍 下 
如 何在 Python 中 使 用 正则 表达 式 模块 。 


11.1.1 字符 搜索 


在 Python 的 RE 模块 中 对 于 字符 搜索 提供 了 两 个 方法 ， 一 个 是 match， 另 一 个 是 


search。 它 们 都 是 接收 一 个 正则 表达 式 的 pattern 来 对 字符 串 进 行 搜 索 ， 不 同 之 处 在 于 match 
只 在 字符 串 的 开头 进行 pattern 匹配 ， 而 search 会 在 任意 位 置 都 进行 匹配 。 具 体 可 以 通过 如 
下 代码 来 理解 。 


#!/usr/bin/env Python 
Oddinpgs vtE-0 = 
import re 


s = 'Hello world' 
pattern_str = 'Hello' 


ml = re.match(pattern str, s) 


if ml: 

print 'matchl: ', ml.group() 
sl1 = re.search(pattern str, s) 
if sl: 

print 'searchl: ', sl.group() 
pattern str2 = 'world' 
m2 = re.match(pattern str2, s) 
if m2: 

print 'match2: ', m2.group() 
S2 = re.search (pattern str2, s) 
4 B24 

print 'search2: ', s2.group() 
运行 结果 如 下 。 


matchl: Hello 
searchl: Hello 
search2: world 


上 述 代码 中 对 于 “ Hello” 的 搜索 ， 两 种 方法 都 能 匹配 成 功 ; 而 对 于 “ world” 的 搜索 ， 


只 有 search 匹配 成 功 ， 而 match 则 匹配 失败 。 因 为 match 只 对 字符 串 开头 进行 匹配 ,“Hello” 
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刚好 在 字符 串 开 头 ， 所 以 匹配 成 功 ， 而 “world” 不 在 字符 串 开头 位 置 ， 所 以 就 匹配 失败 了 。 
前 面 的 pattern 中 只 匹配 了 单个 子囊， 而 如 果 需 要 同时 匹配 多 个 子 串 的 时 候 ， 则 需要 在 
pattern 中 添加 组 的 模式 ， 即 在 pattern 字符 串 中 使 用 小 括号 括 起 来 的 内 容 为 组 ， 具 体 可 以 参考 


如 下 代码 。 


#!/usr/bin/env p 
# -*- coding: ut 
import re 


a = "123abc456" 
pattern = "([0-9 
match obj = re.s 
print match obj 
print match obj 
print match obj 
print match obj. 
print match obj 


ython 
2 


a tk 

earch (pattern, a) 

.group () # 等 价 于 group (0) ， 该 方法 的 默认 参数 即 为 0 
.group (0) #123abc456, 返回 整体 

.group (1) #123， 第 一 个 括号 中 匹配 的 内 容 

group (2) #456， 第 二 个 括号 中 匹配 的 内 容 

-groups () #('123'，'456')， 所 有 组 中 内 容 的 元 组 


代码 中 使 用 小 括号 来 定义 了 两 个 组 ， 并 在 match 对 象 中 通过 group 方法 取得 组 中 匹配 的 
内 容 ，groups 方法 则 直接 返回 所 有 组 匹配 到 的 内 容 。 

此 外 ， 前 面 的 示例 中 pattern 只 匹配 到 一 处 字符 串 ， 而 如 果 被 搜索 的 内 容 比较 多 的 情况 
下 ， 通 常会 匹配 到 多 处 子 串 。 例 如 ， 对 字符 串 “ Hello world，Hello Python ”使 用 “Hello” 


作为 pattern 进行 搜索 ， 
回 第 一 个 匹配 的 内 容 ， 


就 会 有 两 处 子 串 会 被 匹配 到 。 前 面 介 绍 的 match、search 方法 只 能 返 
如 果 想 要 获取 到 所 有 被 匹配 到 的 子 串 内 容 ， 则 可 以 使 用 findall 方法 。 


具体 的 使 用 方式 可 以 参见 如 下 代码 。 


#!/usr/bin/env Python 
条 bg Uf-A 一 < 


import re 


s = "Tina is a good girl , she is cool ,clever, and so on ..." 
print (re.findall (r'\w*oo\w*', s)) ##['good', 'cool'] 
print (re.findall (r' (\w)*oo(\w)', s)) ##[('g', 'd'), ('c’', '1')] 


从 代码 中 可 以 看 到 findall 方法 返回 了 一 个 所 有 匹配 内 容 的 列表 ， 通 过 这 个 列表 就 可 以 获 


取 到 所 有 的 匹配 内 容 。 
所 匹配 到 的 内 容 列表 。 


需要 注意 的 是 ， 如 果 pattern 中 使 用 了 组 模式 ， 则 findall 返回 的 就 是 组 


提示 。 如果 是 在 一 个 非常 大 的 文件 中 进行 fndall 的 匹配 或 搜索 ， 则 建议 改 用 finditer 方 


法 来 替换 findall 方法 ， 


为 finditer 方法 返回 的 是 一 个 迭代 器 ， 它 会 按 需 进行 搜索 和 匹配 ， 


此 在 性 能 上 会 比 fndall 要 更 好 。 
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11.1.2 ”字符 蔡 换 和 分 割 


在 Python 的 RE 模块 中 通过 pattern 不 仅 可 以 进行 字符 的 搜索 ， 还 可 以 进行 字符 的 替换 


和 分 割 ; 具体 来 说 ， 就 是 可 以 把 pattern 匹配 到 的 内 容 蔡 换 为 指定 的 ， 还 可 以 以 pattern 匹配 
到 的 内 容 为 分 隔 符 来 对 原 字符 串 进行 分 割 。 具 体 的 替换 和 分 割 操作 见 如 下 代码 。 


#!/usr/bin/env Python 
# -*- Coding: utf-8 -*- 
import re 


s = "Tina is a good girl , she is cool ,clever, and so on ..." 
print re.subl(r'\w*oo\w*', "HOLDER", s) ## 替换 
print re.split(r'\w*oo\w*', s) ### 分 割 


上 述 代 码 运行 后 分 别 把 匹配 到 的 内 容 进行 了 替换 和 分 割 ， 输 出 的 内 容 如 下 。 


Tina is a HOLDER girl ，she is HOLDER ,clever, and so on ... 
['Tina is a ', ' girl ，she is ', ' ,clever, and so on ...'] 


除了 基本 的 使 用 方式 ， 还 可 以 对 替换 和 分 隔 的 次 数 进行 单独 的 控制 ， 这 个 功能 可 以 通过 


添加 一 个 count 参数 来 调用 。 具 体 参 见 如 下 代码 。 


#!/usr/bin/env Python 
一 ts = 
import re 


s = "Tina is a good girl , she is cool ,clever, and so on ..." 
print re.sub(r'\w*oo\w*', "HOLDER", s, 1) ## 替换 1 次 
print re.split(r'\w*oo\w*', s, 1) ## 分 隔 1 次 


运行 后 的 结果 如 下 所 示 。 


Tina is a HOLDER girl , she is cool ,clever, and so on ... 
DP Tivs TB  * girl ; She ts cool .clever, nd 30 On vos"] 


11.1.3 ”表达 式 修饰 符 


正则 中 的 表达 式 修饰 符 主 要 用 来 对 pattern 的 搜索 规则 进行 设置 ， 例 如 ， 匹 配 时 是 否 大 小 


写字 符 敏 感 等 。 在 Python 的 RE 中 可 以 使 用 的 表达 式 修饰 符 如 以 下 列表 所 示 。 


口 re.I(re.IGNORECASE): 忽略 大 小 写 (括号 内 是 完整 写法 ， 下 同 )。 

口 re.M(re.MULTILINE): 多 行 模式 ， 改 变 人 和 5$' 的 行为 。 

口 re.S(re.DOTALL): 点 任意 匹配 模式 ， 改 变 "… 的 行为 ,设置 后 可 以 匹配 m。 

口 re.L(re.LOCALE): 使 预定 字符 类 \w \W \b \B \s \S 取决 于 当前 区 域 设 定 。 

口 re.U(re.UNICODE) : 使 预定 字符 类 \w \W \b \B \s \S \d \D 取决 于 unicode 定义 的 字符 
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属性 。 

口 re.X(re.VERBOSE) : 详细 模式 。 这 个 模式 下 正则 表达 式 可 以 是 多 行 ， 忽 略 空白 字符 ， 
并 可 以 加 入 注释 。 

而 具体 可 以 支持 表达 式 修饰 符 的 RE( 函数 列表 如 下 。 

DD re.compile(pat, string, flag=0) 

口 re.findall(pat, string, flag=0) 

口 re.match(pat, string, flag=0) 

口 re.search(pat, string, flag=0) 

上 述 方法 中 的 flag 参数 就 是 用 来 接收 表达 式 修饰 符 的 ， 如 果 要 使 用 多 个 标识 ， 则 格 

式 为 : 


下 和 


注意 ”如果 pattern 需要 支持 对 跨行 内 容 的 匹配 ， 需 要 用 到 的 表达 式 修饰 符 为 re.S， 而 不 
是 re.M; re.M 只 对 包含 ^ 和 8$ 字符 的 pattern 有 影响 。 


11.1.4， 其 他 事项 


前 面 几 节 主 要 介绍 了 Python 中 正则 表达 式 RE 模块 的 基本 使 用 ， 这 些 操作 方法 在 日 常 的 
工作 中 会 被 经 常 使 用 到 ; 而 除了 这 些 基本 的 操作 方法 ， 在 使 用 RE 模块 的 时 候 还 有 一 些 其 他 
事项 需要 提醒 下 。 例 如 ， 预 编译 、 贪 禁 匹 配 的 概念 。 

在 RE 中 的 预 编译 指 的 是 对 pattern 内 容 进行 预 编译 ， 其 作用 是 减少 匹配 时 编译 pattern 
的 次 数 ， 从 而 在 整体 上 提高 匹配 性 能 。 例 如 ， 对 于 某 个 pattern 需要 进行 多 次 匹配 操作 ， 那 么 
就 可 以 对 该 pattern 进行 预 编 译 ， 之 后 就 可 以 使 用 编译 后 的 对 象 进行 匹配 操作 。 具 体 的 实现 参 
见 如 下 代码 。 

#!/usr/bin/env python 


0 
import re 


s = "Tina is a good girl , she is cool ,clever, and so on ..." 
S2 = "Cats are smarter than dogs" 
Pattern = r'\w*an\w*' 


p = re.compile (pattern) ## 预 编译 
print p.search(s) .group() ## => and 
print p.search(s2) .group () ## => than 
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上 述 代码 中 通过 re.compile 方法 对 pattern 进行 了 预 编 译 ， 之 后 就 可 以 通过 编译 后 的 
pattern 对 象 对 不 同 字符 串 进 行 匹 配 了 ; 这 样 在 整个 过 程 中 就 减少 了 一 次 编译 过 程 ， 而 如 果 需 
要 匹配 的 字符 串 有 成 百 上 千 ， 则 性 能 将 会 有 一 个 明显 的 提升 。 

除了 预 编译 之 外 ， 正 则 表达 式 中 还 有 一 个 贪 禁 匹 配 的 概念 ， 即 默认 情况 下 对 于 复数 匹配 
符 来 说 ， 它 们 会 尽 可 能 地 匹配 到 最 后 一 个 符合 条 件 的 字符 。 而 与 之 对 应 的 则 是 非 贪 焚 匹配 ， 
即 复数 匹配 符 只 匹配 到 第 一 个 符合 条 件 的 字符 即 可 。 下 面 通过 查看 如 下 代码 来 理解 什么 是 贪 
禁 匹 配 与 非 贪 焚 匹 配 。 

#1/usr/bin/env python 


间 seodings MEE=8 -== 
import re 


s = '<html><head></head><body></body></html>"' 
print re.search(r'^<.*>',s) .group () ## 默认 的 贪 禁 匹配 模式 
print re.search(r'^<.*?>',s) .group () ## 非 贪 禁 匹 配 模式 


上 述 代码 中 贪 禁 匹 配 的 pattern 中 没有 对 复数 匹配 符 * 做 限制 ， 而 非 贪 焚 匹 配 的 pattern 
中 在 复数 匹配 符 * 之 后 添加 了 一 个 “? ”作为 标识 。 运 行 后 的 结果 如 下 。 


<html><head></head><body></body></html> 
<html> 


即 贪 禁 匹 配 模式 会 尽 可 能 地 匹配 整个 字符 串 中 最 后 一 个 “ >” 字符 才 返 回 ， 同 时 这 也 是 
默认 行为 ; 而 非 贪 焚 匹 配 模式 下 只 匹配 到 第 一 个 “>” 字 符 就 结束 匹配 过 程 ， 并 返回 匹配 到 
的 结果 。 


提示 “ 非 贪 禁 匹 配 模式 在 日 常 的 工作 中 会 经 常 运用 到 ， 需 要 牢 牢记 住 并 深刻 理解 ; 同时 
需要 注意 的 是 ， 非 贪 禁 匹配 模式 中 的 “?” 必 须 放 在 复数 匹配 符 的 后 面 ， 同 时 在 被 限定 字符 
的 前 面 。 复 数 匹 配 符 可 以 是 “*” 或 “+”。 


11.2 XML 读 写 模块 的 学 习 


XML 是 可 扩展 标记 语言 的 简称 ， 大 部 分 读者 都 应 该 对 XML 有 一 定 的 了 解 ， 它 是 标准 通 
用 标记 语言 的 子 集 ， 是 一 种 用 于 标记 电子 文件 使 其 具有 结构 性 的 标记 语言 。 通 俗 点 儿 来 讲 就 
是 可 以 用 来 标记 和 组 织 结构 化 文档 的 语言 。XML 有 自己 的 格式 和 语法 定义 ， 这 些 语 法 结构 
的 设计 主要 是 用 来 存储 结构 化 数据 的 。 

通常 使 用 XML 的 一 个 场景 就 是 ， 程 序 A 把 需要 存储 的 结构 化 数据 通过 XML 的 语法 格 
式 写 人 到 一 个 文档 中 ， 然 后 程序 B 就 可 以 通过 读 取 这 个 XML 文档 来 获 到 该 结构 化 数据 。 换 
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句 话 讲 可 以 认为 XML 的 设计 就 是 专门 用 来 存储 、 传 输 结构 化 数据 的 ， 它 可 以 在 不 同 程序 、 
不 同 编程 语言 、 不 同 平台 之 间 进 行 传输 ， 可 以 说 是 不 同 计算 机 终端 之 间 的 共享 信息 的 载体 。 

虽然 不 同 终端 之 间 共 享 信息 的 方式 有 很 多 ， 例 如 ， 类 变量 、 共 享 内 容 、 管 道 ， 甚 至 是 数 
据 库 ， 但 并 不 影响 XML 的 出 现 和 存在 ， 因 为 不 同 的 共享 信息 方式 都 有 自己 的 适用 场景 和 范 
，XML 的 适用 范围 就 是 在 文件 级 别提 供 信 息 共享 。 

对 于 XML 文件 的 操作 一 般 只 有 读 和 写 ， 在 Python 中 可 以 对 XML 进行 读 写 的 模块 还 是 
很 多 的 ,例如 ，SAX、DOM、ElementTree 等 。 不 同 模块 之 间 在 使 用 和 性 能 上 都 是 有 一 些 差 
异 的 ， 接 下 来 选择 一 个 比较 易 用 的 XML 模块 来 介绍 如 何 对 XML 文件 进行 读 写 操作 ， 这 里 
选择 的 是 ElementTree 模块 。 


11.2.1 读 取 XML 文档 


首先 读 取 XML 字符 内 容 ，ElementTree 模块 提供 了 两 种 方法 分 别 用 来 从 字符 串 和 文件 中 
读 取 ， 如 以 下 代码 片段 所 示 。 


from xml .etree import ElementTree as ET 

tree = ET.fromstring('''<?xml version="1.0" encoding="UTF-8"?> 
<root></root>''') 

tree2 = ET.parse('file to_read') 


需要 注意 的 是 ，fromstring 方法 返回 的 是 XML 内 容 根 节点 的 Element 对 象 ， 而 parse 方 
法 返回 的 则 是 ElementTree 对 象 。 换 种 方式 理解 ， 可 以 通过 tree2.getroot 方法 得 到 其 XML 内 
容 根 节点 的 Element 对 象 。 

在 得 到 root 节点 之 后 ， 可 以 对 XML 文档 的 子 节点 进行 遍历 和 检索 。 对 Element 对 象 进 
行 遍历 的 方法 有 多 种 ， 最 简单 的 就 是 直接 遍历 Element 对 象 ， 如 下 代码 对 XML 文档 进行 遍 
历 操作 。 


<?xml version="1.0"?> 
<data> 
<country name="Liechtenstein"> 
<rank>1</rank> 
<year>2008</year> 
<gdppc>141100</gdppc> 
<neighbor name="Austria" direction="E"/> 


<neighbor name="Switzerland" direction="W"/> 
</country> 
<country name="Singapore"> 

<rank>4</rank> 

<year>2011</year> 

<gdppc>59900</gdppc> 

<neighbor name="Malaysia" direction="N"/> 
</country> 
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<country name="Panama"> 
<rank>68</rank> 
<year>2011</year> 
<gdppc>13600</gdppc> 
<neighbor name="Costa Rica" direction="W"/> 
<neighbor name="Colombia" direction="E"/> 
</country> 
</data> 


如 非特 殊 说 明 ， 本 节 中 接 下 来 的 代码 中 所 使 用 的 XML 内 容 均 以 上 述 内 容 为 准 。 


#!/usr/bin/env python 
#4 =*- coding: utf-=8 一 * 一 
from xml.etree import ElementTree as ET 


root = ET.fromstring(country data as_string) 
for child in root: 
print (child.tag, child.attrib) 


上 述 代 码 执 行 后 的 结果 如 下 所 示 。 


('country', {'name': 'Liechtenstein'}) 
('country', {'name': 'Singapore'}) 
('country', {'name': 'Panama'}) 


从 结果 中 可 以 看 出 ， 直 接 遍 历 Element 对 象 时 得 到 的 是 其 直接 孩子 节点 ; 如 果 需 要 遍历 
非 直接 孩子 节点 的 话 ， 则 可 以 使 用 iter 方法 来 实现 ， 具 体 参见 如 下 代码 。 


#!/usr/bin/env Python 
i oi VEE 
from xml .etree import ElementTree as ET 


root = ET.fromstring(country data as_string) 
for neighbor in root.iter('neighbor') : 
Print (neighbor .attrib) 


上 述 代 码 的 运行 结果 如 下 所 示 。 


{'direction': 'E', 'name': 'Austria'} 
{'direction': 'W', 'name': 'Switzerland'} 
{'direction': 'N', 'name': 'Malaysia'} 
{'direction': 'W', 'name': 'Costa Rica'} 
{'direction': 'E', 'name': 'Colombia'} 


同样 可 以 看 出 ， 这 次 遍历 的 是 所 有 的 neighbor 节点 ， 而 neighbor 节点 在 XML 中 是 
root 节点 的 孙子 节点 。 有 了 iter 方法 之 后 基本 上 就 可 以 遍历 和 查找 任意 子 节点 了 ,但 是 如 果 
只 想 在 直接 孩子 节点 中 查找 或 者 过 滤 的 话 ， 那 么 还 可 以 使 用 findall 方法 ， 具 体 可 以 参见 如 
下 代码 。 
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#!/usr/bin/env Python 
= coding: utf-B -~*— 
from xml.etree import ElementTree as ET 


root = ET.fromstring(country data as_string) 
for country in root.findall('country'): 

rank = country.find('rank') .text 

name = country.get ('name') 

print (name, rank) 


上 述 代码 的 运行 结果 如 下 所 示 。 


('Liechtenstein', '1') 
('Singapore', '4') 
('Panama', '68') 


上 述 代码 中 除了 使 用 fndall 方法 之 外 ， 还 使 用 了 find 方法 。find 方法 与 findall 一 样 只 在 
直接 孩子 节点 中 查找 节点 名 一 致 的 节点 ， 区 别 在 于 find 方 法 只 返回 第 一 个 查找 到 的 子 节点 ， 
而 findall 则 返回 所 有 符合 条 件 的 子 节点 。 

遍历 子 节点 的 方法 基本 就 是 上 述 介 绍 的 几 种 ， 而 当 得 到 具体 的 Element 节点 之 后 ， 就 要 
对 节点 本 身 的 信息 进行 读 取 ; Element 对 象 提供 了 较 友 好 的 信息 读 取 的 方法 和 属性 ， 例 如 ， 
get 方 法 可 以 用 来 读 取 节点 具体 的 属性 ， 而 tag 属性 则 会 返回 节点 的 tag name。 具 体 代码 演示 
可 以 参见 如 下 代码 。 


#!/usr/bin/env python 
类 UL GE = 
from xml.etree import ElementTree as ET 


root = ET.fromstring(country data as_string) 
country = root.find('country') 

print 'tag: ', country.tag 

neighbor = country.find('neighbor') 

print 'tag: ', neighbor.tag 

print 'attrib: ', neighbor.attrib 

print 'get name: ', neighbor.get('name') 
print 'text: ', country.find('rank') .text 


上 述 代 码 的 运行 结果 如 下 所 示 。 


tag: country 

tag: neighbor 

attrib: {'direction': 'E', 'name': 'Austria'} 
get name: Austria 

text: 1 
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11.2.2” 写 入 XML 文档 


11.2.1 节 介 绍 了 使 用 ElementTree 模块 对 XML 内 容 进 行 读 取 操 作 ， 本 节 继 续 介绍 使 用 
ElementTree 模块 对 XML 内 容 进行 修改 和 新 增 操作 。 
首先 介绍 新 建 一 个 XML 文件 的 样 例 ， 具 体 的 步骤 参见 如 下 代码 。 


#!/usr/bin/env python 
# -*- coding: utf-8 -*- 


from xml.etree import ElementTree as ET 


root ET.Element ('root') 

clsl = ET.SubElement (root, 'class') 
clsl.set('name', '101') 

clsl.set ('num', '60') 

cls2 = ET.SubElement (root, 'class') 
cls2.set('name', '102') 


cls2.set('num', '50') 


studentl1 = ET.SubElement (clsl, 'student') 
studentl.text = "Bob' 
student2 = ET.SubElement (cls2, 'student') 
student2.text = 'Amy' 


print ET.dump (root) 
et = ET.ElementTree (root) 


et.write("grade .xml") 


上 述 代码 中 首先 通过 Element 类 创建 一 个 Element 对 象 ， 然 后 再 通过 SubElement 类 
在 root 节点 下 创建 了 两 个 子 节点 cls1、cls2， 并 在 这 两 个 节点 下 分 别 又 创建 一 个 student 
节点 ; 

在 创建 完 节点 后 还 可 以 通过 set 方法 来 设置 节点 的 属性 ， 通 过 给 text 属性 赋值 来 设置 节 
点 的 文本 内 容 ; 最 后 打印 了 整个 XML 树 结 构 并 把 内 容 保存 到 了 grade.xml 文件 中 。 代 码 执行 
之 后 输出 的 XML 内 容 如 下 。 


<root> 
<class name="101" num="60"> 
<student>Bob</student> 
</class> 


<class name="102" num="50"> 
<student>Amy</student> 
</class> 
</root> 
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XML 文档 在 生成 之 后 如 果 有 数据 需要 更 新 的 话 ， 则 要 基于 原来 的 文档 内 容 进行 修改 ， 
在 ElementTree 模块 中 对 XML 文档 的 更 新 也 非常 方便 ,具体 的 修改 和 删除 操作 参见 如 下 
代码 。 


#!/usr/bin/env python 
# =-*~ coding: utf-8 .一 “一 
from xml .etree import ElementTree as ET 


et = ET.parse ("grade.xml") 
root = et.getroot() 


for cls in root: 


if cls.get ('name') == "101': 
root .remove (cls) ## 删除 
else: 
cls.set('update', 'true') ## 更 新 属性 
stu = ET.Element ('student') ## 新 建 
stu.text = "Sam' 
cls.append (stu) ## 追加 


print ET.dump (root) 
et .write("grade .xml") 


上 述 代码 中 先 对 之 前 保存 的 grade.xml 文件 进行 读 取 ， 然 后 遍历 root 下 的 class 节点 并 
删除 掉 name 为 101 的 class 节点 ， 而 对 其 他 class 节点 设置 一 个 update 属性 ， 同 时 追加 一 个 
text 为 Sam 的 student 节点 ; 最 后 把 经 过 修改 之 后 的 内 容 保存 到 grade.xml 文件 中 。 其 代码 执 
行 之 后 的 结果 如 下 所 示 。 

<root> 

<class2 name="102" num="50" update="true"> 
<student>Amy</student> 
<student>Sam</student> 


</class2> 
</root> 


总 结 来 讲 ， 对 XML 文件 的 操作 和 更 新 其 实 就 是 对 文档 中 的 节点 元 素 进行 遍历 、 查 找 、 
更 新 、 保 存 的 过 程 ; 在 ElementTree 模块 中 所 有 的 节点 都 是 同样 的 Element 对 象 ， 都 有 统一 
的 操作 接口 ， 因 此 对 文档 的 操作 非常 简捷 和 方便 。 接 下 来 将 会 介绍 另 一 种 数据 存储 结构 形 
式 一 一 JSON。 


11.3 ”JSON 模块 的 学 习 
11.2 节 介 绍 了 Python 中 对 XML 文件 的 操作 ， 本 节 介 绍 同样 是 数据 存储 结构 的 JSON。 
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JSON 是 JS 对 象 标记 的 简称 ， 它 是 一 种 轻 量 级 的 数据 交换 格式 。 在 JSON 出 现 之 前 我 们 对 结 
构 化 数据 进行 存储 和 传输 时 通常 会 用 到 11.2 节 中 介绍 的 XML 形式 ， 而 JSON 出 现 之 后 就 多 
了 一 个 选择 ， 能 用 XML 保存 的 结构 化 数据 ， 使 用 JSON 同样 可 以 保存 。 

JSON 之 所 以 会 出 现 并 流行 起 来 是 因为 它 的 轻 量 级 ， 主 要 表现 在 JSON 的 层次 结构 简洁 
和 清晰 ， 不 仅 易 于 人 阅读 和 编写 ， 而 且 易于 机 器 解析 和 生成 ， 并 有 效 地 提升 网 络 传输 效率 ， 
相对 于 处 理 同 样 数 据 量 的 XML 文件 来 说 ， 处 理 JSON 的 效率 会 更 高 ， 尤 其 是 在 处 理 大 文件 
数据 时 尤为 明显 。 

前 面 已 经 提 到 过 JSON 格式 非常 适合 机 器 解析 和 生成 ， 所 以 在 Python 中 对 JSON 的 操作 
也 是 很 简单 和 方便 的 ; 在 具体 介绍 代码 操作 之 前 先 来 了 解 下 JSON 字符 串 的 语法 格式 ， 它 主 
要 由 两 类 数据 集合 组 成 ， 一 类 是 用 花 括号 表示 的 KV 键 值 对 集合 ， 另 一 类 是 用 方 括号 表示 的 
列表 集合 ; 并 且 这 两 类 集合 在 语法 上 还 可 以 相互 包含 。 最 简单 的 一 个 JSON 字符 串 可 以 是 如 
下 形式 。 

{"name" : "Lily"} 

即 直接 用 一 对 大 括号 括 起 来 的 一 个 键 值 对 ， 当 然 也 可 以 添加 更 多 的 键 值 对 ， 如 下 面 的 片 
段 所 示 。 


{ 


"name"” : "Lily", 

"age" : 27， 

"sex" : "male", 

"email" : "test@163.com" 


} 
甚至 在 键 值 对 中 还 可 以 包含 一 个 列表 集合 ， 如 下 面 的 片段 所 示 。 


"name" : "Lily", 

"age" : 27, 

WB 3 Tl 

"email" ; "test@163.com", 
"friends" : ["Bob", "Sam", "Grace"] 


} 


当然 还 可 以 在 列表 集合 里 再 包含 一 个 键 值 对 集合 ， 这 里 不 再 一 一 列举 。 通 过 上 面 的 简单 
介绍 ， 相 信 读 者 对 JSON 字符 串 有 了 最 基本 的 了 解 ， 那 么 接 下 来 继续 介绍 在 Python 中 如 何 生 
成 和 解析 JSON 字符 串 。 


11.3.1 JSON 串 生 成 
JSON 之 所 以 容易 被 机 器 所 解析 和 生成 ， 主 要 是 因为 它 的 数据 结构 形式 与 编程 语言 中 


的 数据 结构 非常 相似 。 例 如 ，JSON 中 的 花 括 号 与 
Python 中 的 字典 结构 一 致 ， JSON 中 的 方 括号 与 
Python 中 的 列表 结构 一 致 ， 而 JSON 集合 中 的 基本 
字段 又 可 以 与 Python 中 的 基本 数据 类 型 


上 。 通 过 表 11-1 和 表 11-2 可 以 了 解 JSON 数据 与 
Python 数据 类 型 的 对 应 关系 。 


正 是 因为 有 这 样 的 对 应 关系 ， 所 以 生成 JSON 
串 的 过 程 就 变 成 了 组 装 Python 数据 结构 的 过 程 。 只 
要 把 Python 的 数据 结构 组 装 成 对 应 的 JSON 串 结构 
形式 ， 就 可 以 很 容易 地 得 到 对 应 的 JSON 串 。 例 如 ， 
生成 一 个 最 简单 的 JSON 串 ， 在 Python 中 的 代码 内 
容 如 下 。 


#!/usr/bin/env Python 
= On WEE-B RE 
import json 


d= {"name" : "Lily"} 

print json.dumps (d) 

同样 ， 如 果 要 生成 带 更 多 键 值 对 且 包含 列表 集 
合 的 JSON 串 也 是 非常 容易 的 ， 具 体 见 如 下 代码 。 


## {"name": "Lily"} 


#!/usr/bin/env python 
可 一 = coding: utf-8 一 “一 
import json 


入 到 省 
Lily 
male 
: "test@163.com", 
"friends" : ["Bob", "Sam", "Grace"] 
} 
print json.dumps (d) 
上 述 代 码 的 执行 结果 如 下 所 示 。 
{ 
"email": "test@163.com", 
"age": 277 
WEriends"s ("BoB "San* "Grace*]s, 
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表 11-1 Python 对 象 转换 到 JSON 数据 
Python JSON 
dict object 
list、tuple array 
对 应 
str、unicode string 
int、long、float number 
True true 
False false 
None null 


表 11-2 ”JSON 数据 转换 为 Python 对 象 


JSON Python 
object dict 
array list 
string unicode 
number(int) int、 long 
number(real) float 
true True 
false False 
null None 
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通过 上 述 两 段 代码 的 演示 ， 可 以 很 容易 发 现 Python 的 数据 结构 与 JSON 中 支持 的 数据 结 
构 形式 基本 保持 一 致 ， 只 有 在 某 些 基本 数据 类 型 上 才 会 有 一 些 区 别 。 


11.3.2 ”JSON 串 解 析 


11.3.1 节 介 绍 了 JSON 串 的 生成 ， 其 实 就 是 把 Python 数据 结构 转换 成 JSON 串 的 过 程 。 
本 节 介 绍 JSON 串 的 解析 ， 其 实 就 是 JSON 串 生 成 的 逆 过 程 ， 本 质 上 就 是 把 JSON 串 转换 成 
Python 数据 结构 的 过 程 。 具 体操 作 过 程 可 以 参见 如 下 代码 。 


#!/usr/bin/env python 
oodings vteB -= 
import json 


J tL 
"email":; "test@163.com", 
RSS 2 
"friends": ["Bob", "Sam", "Grace"], 
"name": "Lily", 
"sex": "male" 


Yn 
d = json.loads (json str) 
print 'name: ', d['name'] 
print 'email: ', d['email'] 
代码 中 ， 直 接 通过 json 模块 的 loads 方法 把 JSON 串 转换 为 Python 的 数据 结构 ， 之 后 就 
可 以 对 Python 数据 结构 直接 进行 操作 了 。 


注意 JSON 串 中 最 外 层 的 集合 必须 是 大 括号 所 代表 的 KV 键 值 对 集合 ， 而 不 能 是 大 括 
号 所 代表 的 列表 集合 。 


11.4 MDS、BASE64 编 解 码 


在 Web API 自动 化 测试 过 程 中 ， 除 了 需要 对 前 面 几 节 中 特定 格式 的 响应 内 容 进行 解 
析 和 验证 之 外 ， 有 时 候 在 发 送 请 求 之 前 还 需要 对 请 求 数据 进行 加 工 和 处 理 。 例 如 ， 请 求 头 
Anuthorization 的 信息 数据 就 需要 经 过 BASE64 加 密 方式 进行 编码 。 本 节 介 绍 下 在 Python 中 如 
何 对 数据 内 容 进 行 相关 的 编码 与 加 密 。 
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11.4.1 BASE64 编 解码 


BASE64 是 网 络 上 最 常见 的 用 于 传输 8 位 字 节 代码 的 编码 方式 之 一 ,常用 于 在 URL、 
Cookie、 网 页 中 传输 少量 二 进 制 数据 。BASE64 编码 的 基本 原理 是 把 原 字符 串 中 每 3 个 字 
节 作 为 一 组 ， 然 后 依次 对 每 一 小 组 进行 重新 规划 ， 由 原来 的 3 等 分 平均 划分 为 4 等 分 ， 最 
后 根据 划分 后 的 每 一 个 等 分 中 的 内 容 去 查询 BASE64 对 照 表 ， 都 会 得 到 一 个 对 应 的 字符 。 
最 直观 的 感受 就 是 3 个 字符 的 原 字 符 串 经 过 BASE64 编码 之 后 将 得 到 4 个 新 字符 ， 具 体 见 
表 11-3。 


表 11-3 ”BASE64 编码 解析 


原 字符 串 s 

对 应 ASCII 码 115 

对 应 二 进 制 码 01110011 

重新 划分 后 011100 | no | oo | noo 

高 位 补 0 00011100 00110011 

对 应 十 进 制 码 28 sl 
EE 


BASE64 对 照 表 c 


BASE64 编码 在 每 一 个 语言 里 都 有 内 置 的 库 ，Python 里 也 是 如 此 ， 我 们 可 以 很 方便 地 直 
接 引用 base64 模块 来 对 字符 串 进行 BASE64 编码 。 具 体操 作 参 见 如 下 代码 。 
#!/usr/bin/env python 


# -*- coding: utf-8 -*- 
import base64 


于 

ba64 = base64.b64encode (s) 

print ba64 ## => czEz 
print base64.b64decode (ba64) ## => S13 


可 以 看 到 ， 上 述 代码 中 原 字符 串 “s13” 的 长 度 为 3， 经 过 BASE64 编码 之 后 就 变 成 了 长 
度 为 4 的 内 容 “ czEz”; 同样 还 可 以 注意 到 ， 把 编码 之 后 的 内 容 进行 解码 就 可 以 得 到 原始 字 
符 串 的 内 容 。 


注意 如 果 经 过 BASE64 编码 之 后 的 内 容 是 准备 作为 URL 参 数 的， 那么 需要 把 
b64encode 方法 替换 为 urlsafe_b64encode 方法 。 
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11.4.2 MD5 加 密 


11.4.1 节 中 介绍 的 BASE64 编码 的 特点 是 可 用 于 少量 数据 的 二 进 制 编码 ， 并 且 是 可 以 通 


过 解码 还 原 字 符 串 内 容 的 。 本 节 介 绍 另 一 种 数据 加 密 方式 一 一 MD5 加 密 ， 它 的 特点 是 可 以 对 
大 量 数据 进行 处 理 ， 并 且 是 一 个 不 可 逆 的 过 程 ， 即 不 能 通过 加 密 后 的 内 容 还 原 内 容 。MD5 加 
密 主要 使 用 场景 是 用 于 文件 完整 性 的 校 验 。 


本 质 上 来 讲 ，MD5 加 密 其 实 是 一 个 数据 摘要 提取 的 过 程 ， 也 就 是 说 MD5 加 密 后 的 内 容 


是 根据 数据 本 身 的 特征 计算 出 来 的 ， 而 不 是 像 BASE64 那样 全 文 转 码 而 来 的 ， 所 以 MD5 的 
加 密 内 容 是 不 可 逆 的 ， 同 时 其 长 度 也 是 始终 保持 固定 的 。 


在 Python 中 对 数据 进行 MD5 加 密 也 是 非常 方便 的 ， 可 以 直接 使 用 内 置 的 MD5 或 者 


hashlib 模块 进行 MD5 的 加 密 操作 。 具 体 参见 如 下 代码 。 


#!/usr/bin/env python 
# -*- coding: utf-8 -*- 


import hashlib 


s = 'this is Python book for automation testing' 

m = hashlib.md5 () 

m.update (s) 

print m.hexdigest () ## -> aad8727b5191eb33b048a8a07de4Seff 


m2 = hashlib.md5() 
m2.update (s+' ') 
print m.hexdigest () ## -> ba9a63078189d3b9dd998459a67eal7f 


上 述 代码 中 使 用 的 是 hashlib 模块 对 字符 串 进行 了 MD5 加 密 ， 得 到 的 是 一 个 32 位 长 度 


的 加 密 字符 串 ; 而 一 旦 原始 字符 串 内 容 被 改变 了 ， 哪 怕 是 只 增加 了 一 个 空格 ， 在 重新 进行 
MD5 加 密 的 时 候 ， 得 到 的 将 是 一 个 完全 不 同 的 加 密 字符 串 。 


需要 注意 的 是 ，update 方法 可 以 被 多 次 调用 ， 并且 最 后 生成 MD5 时 使 用 的 数据 是 所 有 


的 update 数据 ， 而 不 是 最 后 一 次 update 方法 传递 的 数据 ， 具 体 可 以 参见 如 下 代码 。 


#!/usr/bin/env Python 
# -*- coding: utf-8 -*- 


import hashlib 


s = 'this is Python book for automation testing' 


sl1 = 'append text" 


m = hashlib.md5 () 
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m.update (s) 
m.update (s1) 
print m.hexdigest () ## -> c4013f8cdb94a80561d4ef697ef96e4d 


m2 = hashlib.md5() 
m2.update (s+s1) ## 拼接 后 再 传递 
print m2.hexdigest () ## -> c4013f8cdb94a80561d4ef697ef96e4d 


从 代码 中 可 以 看 出 ， 使 用 两 次 update 方法 分 别传 递 两 个 字符 串 与 使 用 一 次 update 方法 
一 次 性 传递 两 个 字符 串 的 效果 是 一 样 。 


注意 ”如果 MD5 加 密 的 字符 串 中 包含 中 文 ， 那 么 在 传递 给 update 方法 的 时 候 需 要 先 
进行 具体 的 字符 编码 ; 即 不 能 是 Python 内置 的 unicode 编码 ， 而 必须 是 具体 的 编码 ， 例 如 ， 
utf-8 或 gbk 等 。 因 为 相同 的 中 文 在 不 同 编码 的 情况 下 得 到 的 MD5 值 是 不 一 样 的 ， 所 以 需要 
显 式 地 进行 编码 操作 。 


11.4.3 ”数据 序列 化 


数据 序列 化 在 很 多 的 语言 中 都 支持 ，PHP 中 使 用 的 尤其 广泛 ; 在 Python 中 也 是 可 以 直 
接 把 内 存 中 的 数据 对 象 进行 序列 化 ， 并 存储 到 磁盘 文件 中 ; 然后 在 下 一 次 运行 程序 的 时 候 直 
接 读 取 序列 化 文件 到 内 存 ， 而 不 需要 再 重新 组 装 和 数据 对 象 了 。 所 以 Python 序列 化 使 用 的 场 
景 通常 是 用 来 存储 程序 退出 之 前 的 中 间 结 果 的 ， 尤 其 是 当中 间 结 果 需 要 经 过 大 量 计算 步骤 才 
能 得 到 的 情况 。 

在 Python 中 数据 序列 化 的 过 程 ， 其 实 就 是 把 数据 对 象 从 内 存 中 dump 到 磁盘 文件 的 过 
程 ， 因 此 其 序列 化 文件 可 以 直接 加 载 到 内 存 ， 并 恢复 到 原始 的 数据 场景 。 关 于 Python 中 序列 
化 的 操作 步骤 可 以 参见 如 下 代码 。 


#!/usr/bin/env Python 
# -*- coding: utf-8 -*- 
try: 
import cPickle as pickle 
except ImportError: 
import pickle 


d= dict(name='Bob', age=20, score=88) 
with open('file to dump.txt', "wb') as f: 
pickle.dump (d, f£) ## 从 内 存 序 列 化 到 文件 中 
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with open('file to dump.txt', 'rb') as f: 
d = pickle.load(f) ## 从 序列 化 文件 中 读 取 到 内 存 
Print d ## -> {'age': 20, 'score': 88, 'name': 'Bob'} 


上 述 代码 首先 尝试 导入 cPickle 模块 ， 如 果 失 败 则 导入 pickle 模块 ， 因 为 cPickle 模块 在 
性 能 上 会 更 加 优秀 。 其 次 ， 通 过 dump 方法 把 数据 持久 化 到 文件 中 ， 再 使 用 load 方法 把 数据 
重新 载 人 内 存 中 。 这 就 是 Python 中 序列 化 的 过 程 ， 当 然 除了 能 对 普通 的 数据 结构 进行 序列 
化 ， 还 可 以 对 复杂 的 Python 对 象 进行 序列 化 ， 感 兴趣 的 读者 可 以 自己 尝试 下 。 


CHAPTER 


第 12 章 1 
Python 发 送 HTTP 请 求 


前 面 的 几 个 章节 主要 介绍 的 是 Web API 自动 化 测试 的 一 些 基 础 概念 。 掌 握 了 这 些 基础 
的 概念 之 后 ， 就 可 以 学 习 开 发 脚本 来 进行 Web API 的 自动 化 测试 了 。 本 章 开始 介绍 如 何 编写 
Python 脚本 以 真正 调用 Web API， 以 及 如 何 验证 Web API 返回 的 内 容 。 后 面 的 章节 将 会 基于 
本 章 所 讲解 的 内 容 进行 扩展 和 丰富 ， 使 其 可 以 更 加 工具 化 。 


12.1 HTTP 请 求 发 送 


Web API 是 存在 于 网 络 上 的 服务 接口 ， 如 果 想 要 调用 该 Web 接口 ， 则 需要 通过 网 络 与 之 
进行 通信 ， 本 质 上 就 是 发 送 HTTP 请 求 并 获取 响应 内 容 。 本 节 就 开始 介绍 如 何 利 用 Python 发 
送 HTTP 请 求 。 

在 Python 中 可 以 用 来 发 送 HTTP 请 求 的 模块 有 很 多 ， 内 置 的 模块 如 httplib 、urllib、 
urllib2 等 ; 第 三 方 的 模块 选择 性 则 更 大 ， 如 http、httplib2、requests、pyQuery 等 。 因 为 
requests 模块 在 易 用 性 和 功能 丰富 性 方面 都 有 很 好 的 支持 ， 所 以 这 里 选择 以 requests 模块 为 例 
介绍 如 何 发 送 HTTP 请 求 。 


12.1.1 requests 模块 安装 


如 果 按 照 本 书 介绍 的 方式 搭建 环境 ， 那 么 安装 requests 模块 就 变 得 非常 简单 ， 直 接 使 用 
下 面 的 安装 命令 即 可 开始 安装 。 


令 
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pip install requests 

安装 完成 后 可 以 通过 pip list 命令 查看 是 否 安装 成 功 ， 也 可 以 直接 进入 Python 的 解释 器 
shell 环境 使 用 import requests 命令 来 尝试 导入 requests 模块 。 如 果 没 有 报错 ， 则 表示 requests 
模块 已 安装 成 功 。 安 装 成 功 后 其 显示 结果 如 图 12-1 所 示 。 


画 cNwincowsisystem3zvemd exe - python ey | 


图 12-1 requests 包 导 入 


12.1.2 ”发送 GET 请 求 


requests 模块 安装 完成 之 后 ， 就 可 以 开始 使 用 该 模块 了 。 首 先 来 看 如 何 用 requests 模块 
来 发 送 GET 请 求 。 最 简单 的 一 个 GET 请 求 代码 如 下 。 


import requests 


resp 


上 述 代码 中 只 上 


requests.get('https://api.github.com') 


了 requests 模块 的 get 方法 就 可 以 直接 发 送 GET 请 求 ， 而 请 求 发 送 完 之 


后 响应 信息 被 赋值 给 resp 变量 ， 接 着 就 可 以 通过 resp 变量 来 获取 具体 的 响应 内 容 。 例 如 ， 通 


过 status_code 


属性 获取 响应 状态 码 ， 通 过 headers 属性 来 获取 所 有 的 响应 头 信息 ， 通 过 text 


属性 来 获取 响应 体 的 文本 内 容 。 完 整 的 操作 代码 如 下 。 


#!/usr/bin/env python 
本 
import requests 


r= requests.get('https://api.github.com') 


print 
print 
print 
print 
print 


es 


Es 
bs 
r 


status_code 


.headers['content-type'] 
.encoding 


.text 
.json() 
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代码 中 还 可 以 看 到 响应 体 对 象 的 json 方法 被 调用 了 ， 作 用 是 直接 把 JSON 字符 串 的 响应 
体 转换 为 Python 对 象 。 使 用 该 方法 之 前 请 先 确保 响应 体内 容 为 标准 的 JSON 格式 。 运 行 代码 
之 后 的 输出 结果 如 下 。 


200 

application/json; charset=utf-8 

utf-8 

{"current user url":"https://api.github.com/user",...} 
{u'issues url': u'https://api.github.com/issues',...} 


注意 代码 中 使 用 的 url 是 HTTPs， 如 果 你 的 Web API 是 HTTP， 则 需要 更 新 url 为 
“http://” 前 级 。 


前 面 发 送 的 是 一 个 默认 的 GET 请 求 ， 即 url 中 没有 带 特定 的 参数 ， 而 有 时 候 Web API 的 
接口 是 需要 带 参数 的 。 在 requests 中 ， 如 果 需 要 发 送 带 参数 的 请 求 ， 当 然 不 需要 自己 去 拼接 
KV 键 值 对 的 字符 串 ， 可 以 直接 传递 一 个 字典 对 象 给 它 ， 剩 下 的 就 交 给 requests 来 处 理 。 具 
体 见 如 下 代码 。 

#!/usr/bin/env Python 


# -*- coding: utf-8 -*- 
import requests 


payload = {'keyl': 'valuel', 'key2': 'value2'} 

r= requests.get ("http://httpbin.org/get", params=payload) 
print r.status_code 

print r.url 


上 述 代码 中 的 请 求 地 址 http://httpbin.org/get 是 一 个 HTTP 镜像 服务 ， 即 它 会 把 发 送 过 去 
的 内 容 全 部 返回 ， 通 常 作 为 调试 HTTP 请 求 的 工具 ; 而 我 们 代码 中 打印 的 rurl 其 实 就 是 我 们 
实际 发 送 过 去 的 URL 内 容 ， 其 具体 内 容 如 下 所 示 。 

http://httpbin.org/get?key2=value2&keyl=valuel 

可 以 看 出 ，requests 模块 已 经 把 我 们 传递 过 去 的 字典 参数 转换 成 了 对 应 的 KV 对 字符 串 。 
需要 注意 的 是 ， 如 果 字 上 典 参数 中 有 值 为 None 的 子 项 ， 则 不 会 被 添加 到 url 中 作为 参数 ; 另 
外 ， 如 果 请 求 参 数 中 某 些 键 有 多 个 值 的 情况 ， 则 可 以 在 字典 参数 中 给 该 键 值 赋值 一 个 列表 对 
象 ， 如 以 下 代码 所 示 。 


#!/usr/bin/env python 
OU tS -~#— 
import requests 


payload = {'keyl': 'valuel', 'key2': ['value2', 'value3']} 
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r= requests.get ("http://httpbin.org/get", params=payload) 
print r.status code 
print r.url 


上 述 代 码 的 执行 结果 如 下 所 示 。 


200 
http://httpbin.org/get?key2=value2&key2=value3&keyl=valuel 


可 以 看 到 请 求 参 数 中 有 两 个 key2 参数 ， 并 且 分 别 赋予 参数 列表 中 不 同 的 值 。 关 于 
requests 的 GET 请 求 使 用 方法 就 介绍 到 这 里 ， 接 下 来 介绍 如 何 发 送 POST 请 求 。 


12.1.3 发 送 POST 请 求 


在 requests 模块 中 发 送 POST 请 求 跟 发 送 GET 请 求 相 似 ， 只 需 直接 调用 post 方法 即 可 。 
例如 下 面 的 代码 片段 。 

r= requests.post("http://httpbin.org/post") 

同样 地 ， 如 果 需 要 发 送 带 请 求 体 的 POST 请 求 ， 则 可 以 传递 一 个 字典 参数 ， 如 下 面 的 代 
码 片段 。 


payload = {'keyl': 'valuel', 'key2': 'value2'} 
r= requests.post ("http://httpbin.org/post", payload) 


到 目前 为 止 发 送 的 参数 都 是 默认 的 类 型 ， 即 前 面 章 节 中 提 到 的 Content-Type 为 
application/x-www-form-urlencoded ; 而 如 果 想 要 发 送 Content-Type 为 JSON 格式 的 请 求 体 ， 
那么 就 要 在 发 送 请 求 之 前 添加 对 应 的 请 求 头 信息 。 具 体 的 完整 代码 如 下 。 


#!/usr/bin/env Python 
a 一 CALig: GE 一 :一 
import requests, json 


payload = {'keyl': 'valuel', ‘key2': 'value2'} 
headers = {'content-type': 'application/json'} 
r = requests.post ("http://httpbin.org/post", json.dumps (payload), 


headers=headers) 
print r.status code 
print r.text 


上 述 代 码 中 主动 添加 了 Content-Type 请 求 头 信息 ， 并 且 在 传递 数据 参数 的 时 候 把 Python 
字典 对 象 转换 成 了 JSON 串 ， 和 否则 requests 会 自动 把 Python 字典 对 象 转换 成 x-www-form- 
urlencoded 形式 。 此 外 ， 还 有 另 一 种 方法 来 达到 上 述 代码 的 效果 ， 具 体 参 见 如 下 代码 。 

#!/usr/bin/env Python 


#4 = coding: atE=-8 一 “一 
import requests, json 
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payload = {'keyl': 'valuel', "key2': 'value2'} 

r= requests.post ("http://httpbin.org/post", json=payload) 
print r.status code 

print r.text 


上 述 代 码 中 直接 把 Python 的 字典 对 象 传递 给 post 方 法 的 json 参数 ， 而 requests 在 内 部 
会 自动 地 把 它 转换 为 JSON 串 ， 并 添加 上 Content-Type 请 求 头 信息 。 可 以 看 到 requests 中 发 
送 各 类 POST 请 求 也 非常 容易 ! 接 下 来 看 下 如 何 发 送 一 个 带 文件 的 POST 请 求 。 


12.1.4 ”发送 multipart/form-data 请 求 


在 第 9 章 中 提 到 过 ，HTTP 的 请 求 体 类 型 大 致 可 以 分 为 三 类 : Query String、 文 件 分 割 
和 其 他 类 型 。 其 中 ，Query String 指 的 就 是 x-www-form-urlencoded 类 型 ， 其 他 类 型 指 的 是 
包括 JSON、XML 在 内 的 自 定义 数据 类 型 ， 这 两 种 请 求 在 12.1.3 节 中 分 别 进行 了 介绍 ， 而 
所 谓 的 文件 分 割 类 型 其 实 就 是 multipart/form-data 类 型 ， 这 也 是 本 章 将 要 介绍 的 POST 请 求 
类 型 。 

multipart/form-data 的 POST 请 求 跟 其 他 类 型 的 POST 请 求 的 不 同 之 处 在 于 ， 它 会 把 指 
定 文件 的 二 进 制 内 容 作为 请 求 体 的 一 部 分 一 起 发 送 到 服务 器 端 ， 同 时 它 还 要 标记 字段 名 、 文 
件 名 、 文 件 类 型 等 信息 ， 所 以 它 的 请 求 体格 式 就 比 其 他 的 POST 请 求 体 要 复杂 。 具 体 而 言 ， 
multipart/form-data 请 求 体 中 的 不 同 字 段 之 间 是 由 一 个 特定 内 容 的 分 隔 符 分 隔 开 的 ， 分 隔 后 的 
每 一 个 小 段 中 就 可 以 独立 地 描述 该 字段 的 各 种 信息 而 不 会 再 互相 干扰 ， 而 这 个 分 隔 符 则 取 自 
请 求 头 中 的 Content-Type 字段 中 。 关 于 multipart/from-data 请 求 报 文 的 详细 结构 请 回顾 第 9 
章 中 的 相关 内 容 。 

在 requests 中 上 传 文件 的 请 求 也 变 得 非常 简单 ， 前 面 提 到 的 各 种 分 隔 符 、 请 求 头 概念 在 
requests 中 都 不 需要 自己 去 处 理 ， 唯 一 要 做 的 就 是 传递 文件 相关 的 参数 信息 即 可 ， 如 以 下 代 
码 所 示 。 


#!/usr/bin/env python 
ding LCE-8 一 后 
import requests 


files = {'file': open('report.xlsx', 'rb')} 

r= requests.post ("http://httpbin.org/post", files=files) 
print r.status_code 

print r.text 


在 这 里 只 要 以 二 进 制 的 方式 打开 一 个 文件 句柄 ， 并 赋值 给 一 个 字段 名 ， 再 把 数据 字典 对 
象 传递 给 post 方法 的 files 参数 即 可 。 当 然 还 可 以 指定 这 个 文件 段 的 一 些 描述 信息 ， 例 如 文 
件 名 、 文 件 类 型 等 ， 具 体 参 见 如 下 代码 。 
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#!/usr/bin/env Python 
GE 一“ 
import requests, json 


files = {'file': 
( 
'test.xlsx', 
open('report.xlsx', 'rb'), 


'application/vnd.ms-excel', 


{'Expires': '0'} 
) 


## 字段 名 


### 指定 文件 名 
## 文件 句柄 
### 文件 类 型 
### 请 求 头 信息 


r= requests.post ("http://httpbin.org/post", files=files) 


print r.status_code 
print r.text 


上 述 代码 中 显 式 地 指定 了 文件 名 、 文 件 类 型 等 。 如 果 没 有 指定 ，requests 会 根据 给 定 的 


文件 句柄 来 自动 获取 这 些 信息 。 


12.1.5 ”发送 其 他 类 型 请 求 


在 requests 中 除了 可 以 支持 前 面 内 容 中 介绍 的 GET、POST 的 请 求 之 外 ， 还 可 以 支持 几 
种 其 他 类 型 的 HTTP 方法 ， 例 如 PUT、DELETE、HEADER 等 。 具 体 的 使 用 方式 参见 如 下 


代码 。 


#!/usr/bin/env Python 
天 WE 
import requests 


requests.put ("http://httpbin.o 
requests.delete("http://httpbi 
requests.head("http://httpbin. 
requests.options ("http://httpb 


H HH H 8 
人 


rg/put") 
n.org/delete") 
org/get") 
in.org/get") 


可 以 看 到 一 如 既往 的 requests 代码 风格 ， 对 于 可 以 支持 请 求 体 的 方法 其 使 用 方法 和 


POST 方法 一 致 。 


12.2 HTTP 请 求 认证 


在 此 之 前 ， 发 送 的 所 有 HTTP 请 求 都 是 不 需要 带 身份 认证 的 。 如 果 访 问 的 是 一 个 需要 身 
份 验证 的 接口 ， 那 么 在 发 送 请 求 的 同时 ， 带 上 合法 有 效 的 身份 认证 信息 才能 请 求 成 功 。 


在 Web API 上 可 以 使 用 的 身份 认证 有 


许多 不 同 的 类 型 ， 依 据 不 同 的 服务 提供 商 的 需求 ， 


可 能 会 使 用 不 同 的 身份 认证 机 制 ， 而 本 节 将 介绍 requests 中 可 以 支持 的 几 种 身份 认证 形式 。 
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12.2.1 HTTP Basic Auth 


Basic Auth 是 Web 上 最 简单 的 一 种 身份 认证 ， 它 是 通过 在 HTTP 的 Authorization 请 求 头 
中 携带 经 过 BASE64 加 密 的 用 户 名 和 密码 而 实现 的 一 种 认证 方式 。 服 务 端 在 接收 到 HTTP 请 
求 时 会 读 取 Authorization 头 信息 ， 并 解密 其 内 容 ， 从 而 获取 用 户 名 和 密码 ， 之 后 再 去 同 数据 
库 中 的 用 户 名 和 密码 进行 验证 。 

在 requests 中 对 Basic Auth 的 支持 是 开 箱 即 用 的 级 别 ， 如 以 下 代码 所 示 。 


#!/usr/bin/env Python 

= odings tL = 

import requests 

from requests.auth import HTTPBasicAuth 


r= requests.get('https://api.github.com/user', 
auth=HTTPBasicAuth('user', 'password')) 

print r.status_code 

print r.text 


其 中 ，user、password 需要 替换 成 真实 有 效 的 账户 和 密码 ， 在 账户 信息 正确 的 情况 下 会 
返回 与 该 用 户 相 关 的 一 些 基 本 信息 ， 例 如 ID、 用 户 名 、 头 像 url 等 。 由 于 Basic Auth 身份 认 
证 比较 常用 ， 所 以 在 requests 中 对 于 Basic Auth 还 有 更 简单 的 一 种 写法 ， 参 见 如 下 代码 。 


#!/usr/bin/env Python 
机 = oding; WEE-6 -一 “一 
import requests 


r= requests.get ('https://api.github.com/user' 
auth=('user'，'password')) 

Print r.status_code 

print r.text 


12.2.2 HTTP Digest Auth 


Digest Auth 是 摘要 式 身 份 认证 ， 也 是 Web 上 比较 常用 的 一 种 认证 方式 。 这 种 形式 的 认 
证 在 客户 端 第 一 次 请 求 的 时 候 会 进行 摘要 盘问 并 返回 一 组 参数 ， 客 户 端 根据 这 些 参 数 生成 摘 
要 响应 并 附带 在 下 一 次 请 求 中 ， 服 务 器 在 接收 到 带 有 摘要 响应 的 请 求 时 ， 也 要 重新 计算 响应 
中 各 参数 的 值 ， 如 果 计 算出 来 的 结构 与 客户 端 一 致 ， 则 认证 成 功 。 

在 requests 中 对 于 Digest Auth 身份 认证 的 支持 也 是 很 方便 的 ， 具 体 实现 如 以 下 代码 
所 示 。 

#!/usr/bin/env python 


类 coding: AtEE 一 5 一 和 一 
import requests 
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from requests.auth import HTTPDigestAuth 


url = 'http://httpbin.org/digest-auth/auth/user/pass' 

r= requests.get (url, auth=HTTPDigestAuth('user', 'pass')) 
print r.status code 

print r.text 


其 中 的 user、pass 同样 要 蔡 换 成 真实 有 效 的 账户 信息 。 


12.2.3 ”OAuth 认证 


OAnuth 认证 是 目前 比较 流行 的 一 种 身份 认证 方式 ， 通 常用 于 Web API 之 上 。OAnuth 认证 


有 OAuthl 和 OAuth2 两 个 版 本 。 由 于 篇 由 有限， 关于 OAuth 工作 流程 的 更 多 信息 ， 请 参见 
OAuth 官方 网 站 https://oauth.net/。 


这 里 看 一 下 在 requests 中 如 何 直接 使 用 OAuthl 认证 接口 ， 具 体 实现 见 如 下 代码 。 


#!/usr/bin/env Python 

兴 og: WEE 

import requests 

from requests oauthlib import OAuthl 


url = 'https://api.twitter.com/1.1/account/ 
verify credentials.json’' 
auth = ORuthl ('YOUR APP KEY', ‘YOUR APP SECRET', 
'USER_OAUTH TOKEN', 'USER _ OAUTH TOKEN _ SECRET') 
r= requests.get (url, auth=auth) 
print r.status_ code 
print r.text 


其 中 ， 只 需要 把 YOUR_APP KEY、YOUR_APP_SECRET、USER_OAUTH_TOKEN、 


USER_OAUTH_TOKEN_SECRET 替换 成 服务 提供 商 分 配 的 真实 值 即 可 。 而 关于 OAuth2 的 
认证 流程 在 requests 中 暂 未 集成 ， 但 是 可 以 直接 使 用 requests_oauthlib 库 来 完成 OAuth2 方式 
认证 ， 具 体 样 例 请 参见 官方 地 址 http://requests-oauthlib.readthedocs.io/en/latest/examples/real_ 


world_ example.html。 


注意 执行 代码 之 前 需要 先 安装 requests_oauthlib 模块 ， 可 以 使 用 安装 命令 pip install 


requests_oauthlib 来 进行 安装 。 


12.2.4” 自 定义 认证 


除了 前 面 提 到 过 的 一 些 Web 标准 认证 方式 ， 某 些 服务 提供 商 也 会 提供 自 定义 的 认证 


机 制 ， 此 时 就 需要 自 定 义 一 个 认证 类 支持 requests 模块 。 假 设 有 一 个 认证 场景 是 当 请 求 头 
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isLogin 的 值 为 True 时 就 认为 身份 认证 成 功 (当然 不 会 有 这 样 的 场景 ， 举 例 而 已 )， 那 么 自 定 
义 认证 的 类 就 可 以 用 如 下 代码 这 样 写 。 
#!/usr/bin/env python 


ooding: utt-0 =- 
import requests 


class MyAuth (requests.auth.AuthBase): 
‘def ‘call ‘(self, z): 
r.headers['isLogin'] = True 
return r 


Url = 'http://httpbin.org/get' 

r= requests.get (url, auth=MyAuth()) 
print r.status_code 

print r.text 


代码 中 自 定义 认证 类 继承 自 requests.auth.AuthBase 类 ,并且 实 现 了 _call 方法, 方法 
体 中 直接 给 request 对 象 添加 上 isLogin 请 求 头 并 设置 值 为 True， 而 实际 在 请 求 发 送 时 就 会 自 
动 把 请 求 头 isLogin 附带 上 。 


12.3 URL 的 编 解码 


尽管 在 requests 中 发 送 数 据 时 已 无 须 再 进行 URL 编码 ， 但 是 作为 HTTP 请 求 中 可 能 引 
发 请 求 失败 的 一 个 因素 ， 还 是 应 该 掌握 URL 的 编 解码 相关 知识 。 
URL 编码 指 的 是 一 种 专门 用 来 打包 Web 表单 输入 的 格式 。URL 编码 遵循 下 列 规则 : 每 
对 name/value 由 人 符 分 开 ; 而 name/value 之 间 由 = 符 分 开 。 在 name 或 value 中 如 果 出 现任 
何 特殊 的 字符 (如 汉字 ) 将 以 百 分 符 % 加 上 其 十 六 进 制 编码 表示 ， 当 然 也 包括 像 =、&& 和 % 
这 些 特殊 的 字符 。 其 实 URL 编码 就 是 一 个 字符 ASCII 码 的 十 六 进 制 。 
通过 URL 编 解 码 流程 可 以 很 容易 地 理解 URL 编码 。 首 先 ，Web 客户 端 (如 浏览 器 ) 获 
取 需 要 传输 的 表单 数据 并 对 其 进行 URL 编码 。 得 到 编码 后 的 数据 后 再 发 送 给 服务 器 端 。 服 
务 器 在 接收 到 数据 后 会 先 对 其 进行 解码 的 过 程 ， 解 码 之 后 得 到 的 将 是 表单 里 的 原始 提交 数 
据 。 具 体 的 数据 变化 如 以 下 代码 所 示 。 
表单 数据 : 
<form action="/" type="GET"> 
<input type="text" name="lang" value="python" /> 
<input type="text" name="type" value="testing" /> 


<input type="text" name="country"” value=" 中国 " /> 
</form> 
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URL 编码 后 : 
lang=pythongtype=testing&gcountry=%E4%B8%AD%SE5%9B%SBD 


URL 解码 后 : 
"lang" : "python", 
"type" : "testing", 
"country”: "中 国 " 
} 


通过 上 述 代码 可 以 看 到 ， 普 通 的 ASCI 码 字符 (如 英文 ) 在 编码 前 后 并 没有 任何 
改变 ， 而 中 文字 符 在 编码 前 后 的 内 容 已 经 改变 ,“ 中 国 ” 两 个 中 文字 符 在 编码 后 变 成 
“%E4%B8%AD%E5%9B%BD”，% 是 URL 编码 的 前 级 ，E4 之 类 的 则 是 ASCII 的 十 六 进 制 
表示 。 
那么 在 Python 中 如 果 不 使 用 requests 发 送 HTTP 请 求 ， 该 怎么 给 请 求 数据 进行 编码 呢 ? 
答案 就 是 使 用 urllib 的 urlencode 方 法 ， 同 样 的 请 求 数据 使 用 urlencode 编码 之 后 其 结果 也 是 


# 的 ， 参 见 如 下 代码 。 


#!/usr/bin/env Python 
和 oding; wtf-0 一 上 


import urllib 

d= {'lang':'python', 'type':'testing'，'country' : ' 中 国 ' 
print urllib.urlencode (d) 

上 述 代 码 的 运行 结果 如 下 。 
lang=python&gcountry=%E4%B8%ADSE5%9BSBDgtype=testing 


除了 编码 ，Python 中 也 有 对 应 的 URL 解码 的 方法 ,使 用 方式 也 很 简单 ， 


代码 。 


#!/usr/bin/env python 
ER Ute 


import urllib 
s = 'lang=pythongcountry=%E4%B8%ADSES5%9BSBDgtype=testing’' 
print urllib.unquote(s) 


上 述 代码 执行 后 的 结果 如 下 。 


lang=pythongcountry= 中 国 gtype=testing 


具体 参见 如 下 


可 以 看 到 ,使 用 的 是 urllib 的 unquotes 方法 进行 URL 解码 ， 把 字符 串 中 的 编码 字符 替 
换 成 了 原始 字符 。 
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提示 “其实 还 可 以 使 用 urllib 的 quotes 方法 对 字符 串 进 行 编 码 ， 刚 好 与 unquotes 方法 效 
果 相 反 。quotes 方法 与 urlencode 方法 的 区 别 在 于 接收 的 参数 形式 不 同 ，quotes 接收 字符 串 ， 


urlencode 接收 字典 对 象 。 


12.4 HTTP 响应 内 容 验 证 


前 面 介绍 了 如 何 使 用 Python 发 送 各 种 HTTP 请 求 及 注意 事项 ， 但 是 作为 Web API 测试 
来 讲 ， 能 够 发 送 正确 的 HTTP 请 求 只 是 完成 前 半 部 分 工作 而 已 ， 后 半 部 分 的 Web API 测试 工 
作 则 是 对 HTTP 响应 内 容 的 验证 。 接 下 来 将 介绍 在 Web API 的 自动 化 测试 中 需要 对 响应 内 容 


进行 哪些 验证 。 


12.4.1 ”状态 码 验 证 


在 HTTP 返回 的 内 容 中 包括 三 类 信息 : 响应 行 、 响 应 头 和 响应 体 。 这 三 类 信息 都 可 以 是 
需要 进行 验证 的 对 象 ， 而 对 于 响应 行 而 言 基本 上 只 对 其 中 的 状态 码 进行 验证 。 

HTTP 中 状态 码 可 以 分 为 5 类 ， 每 一 类 状态 码 分 别 代表 某 一 类 反馈 信息 ， 如 下 所 示 。 

口 1XX (消息 ): 代表 请 求 已 被 接受 ， 需 要 继续 处 理 ; 通常 情况 不 会 出 现 。 

口 2XX (成 功 ): 代表 请 求 已 成 功 被 服务 器 接收 、 理 解 ， 并 接受 。 

口 3XX ( 重 定向 ): 代表 需要 客户 端 采取 进一步 的 操作 才能 完成 请 求 。 

口 4XX (请 求 错误 ): 代表 客户 端 看 起 来 可 能 发 生 了 错误 ,妨碍 了 服务 器 的 处 理 。 


口 SXX、6XX (服务 器 错误 ): 代表 服务 器 在 处 理 请 求 的 过 程 中 有 错误 或 者 异常 状态 发 生 ， 


也 有 可 能 是 服务 器 意识 到 以 当前 的 软 硬 件 资源 无 法 完成 对 请 求 的 处 理 。 
并 且 每 一 类 状态 中 又 有 很 多 细 分 状态 码 。 例 如 ，200 代表 请 求 成 功 ， 响 应 正常 ; 301 代 
表 被 请 求 的 资源 已 永久 移动 到 新 位 置 ; 401 代表 当前 请 求 需要 用 户 验 证 或 者 验证 信息 错误 ; 
500 代表 服务 器 遇 到 了 一 个 未 曾 预料 的 状况 ， 导 致 了 它 无 法 完成 对 请 求 的 处 理 〈 即 服务 器 代 


码 有 Bug)。 


在 Web API 自动 化 测试 中 ， 所 要 验证 的 也 就 是 这 些 子 状态 码 。 对 于 发 送 的 正确 请 求 和 参 
数 要 验证 其 返回 状态 码 为 200， 而 对 于 错误 的 请 求 或 参数 要 验证 其 返回 对 应 的 状态 码 值 。 


在 requests 中 验证 状态 码 的 步 又 如 以 下 代码 所 示 。 
#!/usr/bin/env Python 
# = BOD EES =#= 


import requests 


SUCCESS _ CODE = 200 
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r= requests.get ("http://httpbin.org/get") 
if r.status code == SUCCESS_CODE: 

print 'success' 
else: 

print 'failure' 


可 以 直接 通过 requests 的 response 对 象 的 status_code 属性 获取 到 状态 码 ， 然 后 再 拿 这 个 
状态 码 与 期 望 的 状态 码 进行 等 值 比较 ， 如 果 一 致 则 说 明 验 证 通过 ， 否 则 验证 失败 。 


12.4.2 ”响应 头 验 证 
在 响应 头 的 验证 中 主要 验证 是 否 包含 指定 的 响应 头 或 者 响应 头 的 值 是 否 为 期 望 内 容 ， 可 
能 需要 进行 验证 的 响应 头 例如 Content-Type、Location 等 。 在 requests 中 对 响应 头 进行 验证 的 
方式 可 以 参见 如 下 代码 。 


#!/usr/bin/env python 
# -*- coding: utf-8 -*- 
import requests 


PASS = True 
CHECK_HEADER_ONLY = False 
EXPECT_HEADERS = { 

'content-type': 'application/json' 


} 
r= requests.get ("http://httpbin.org/get") 


actual headers = {} 
for k, v in r.headers.items(): 
actual headers[k.lower()] = v 


for K, V in EXPECT_HEADERS.items(): 
if K in actual headers: 
if CHECK HEADER_ONLY: 
pass 


elif actual headers[K] .startswith(V) : 


pass 
else: 
PASS = False 
break 
else: 
PASS = False 
break 


if PASS: 

print "Success' 
else: 

print 'failure' 


## 是 通过 flag 
## 是 否 只 检查 响应 头 
## 期 望 的 响应 头 包含 内 容 


## 把 响应 头 都 转 为 小 写 


## 检查 期 望 的 header 是 否 存在 
## 是 否 只 检查 响应 头 


## 检查 响应 头 值 
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代码 中 首先 定义 了 PASS、CHECK_HEADER_ONLY、EXPECT_HEADERS 这 三 个 变量 ， 
分 别 用 来 保存 测试 的 结果 、 定 义 是 否 只 检查 响应 头 而 不 检查 响应 头 的 值 、 定 义 期 望 包含 的 响 
应 头 及 其 对 应 值 。 其 次 发 送 一 个 请 求 并 通过 response 对 象 的 headers 属性 获取 实际 响应 头 信 
息 ， 此 后 对 实际 响应 头 进行 遍历 并 把 响应 头 的 值 都 转换 成 小 写 的 。 最 后 遍历 期 望 响 应 头 并 验 
证 每 一 个 响应 头 是 否 都 出 现在 实际 响应 头 中 ， 并 且 如 果 CHECK_HEADER_ONLY 为 True， 
则 只 会 检查 响应 头 不 会 检查 响应 头 的 值 是 否 也 匹配 。 


12.4.3 ”响应 体验 证 


在 Web API 的 自动 化 测试 中 ， 虽然 有 时 也 会 对 状态 码 甚至 是 响应 头 进行 验证 ， 但 响应 体 
的 验证 才 是 真正 的 重点 。 由 于 响应 体 的 内 容 格 式 多 种 多 样 ， 例 如 有 XML、JSON 等 ， 而 且 对 
于 要 验证 的 具体 内 容 在 不 同 的 API 中 也 是 不 固定 的 ， 因 此 对 于 响应 体 的 验证 比 状态 码 、 响 应 
头 的 验证 要 复杂 些 。 

为 了 能 够 较 高 效 地 对 响应 体 进行 验证 ， 需 要 设计 一 些 通用 的 验证 方式 ， 例 如 ， 支 持 全 文 
匹配 、 全 文 检索 、 正 则 查询 等 。 而 对 于 具有 特定 格式 的 内 容 也 可 以 设计 一 些 有 针对 性 的 验证 
方式 , 例如 ,对 于 XML 可 以 支持 XPATH 检索 ， 对 于 JSON 可 以 支持 JSONPATH 检索 等 。 

本 节 分 别 以 普通 文本 、XML 文本 、JSON 文本 为 例 ， 来 介绍 如 何 对 响应 体 进行 有 针对 性 
的 验证 。 

首先 来 看 看 对 普通 文本 的 检查 ， 大 概 有 三 种 : 全 文 匹 配 、 全 文 检索 和 正则 查询 。 全 文 匹 
配 就 是 验证 响应 体内 容 必须 为 指定 的 内 容 ， 多 一 个 符号 都 不 通过 ; 全 文 检索 就 是 验证 在 响应 
体 中 搜索 特定 的 内 容 ， 只 要 能 检索 到 则 表示 通过 ， 否 则 不 通过 ; 正则 查询 则 是 指 可 以 通过 一 
个 正则 表达 式 来 匹配 响应 体内 容 ， 如 果 匹 配 成 功 则 通过 ， 和 否则 不 通过 。 这 三 种 形式 的 验证 代 
码 如 下 所 示 。 


#!/usr/bin/env Python 
Godings ES 一 = 一 
import requests, re 


PASS = True 

EXPECT_TEXT = u'... 此 处 替换 为 完整 的 响应 体内 容 . . . 
EXPECT_SUBSTRING = urHost' 

EXPECT_REGEX = u'http://.*?/get' 


r= requests.get ("http://httpbin.org/get") 
res = r.text 


if res != EXPECT TEXT: ## 全 文 匹配 
PASS = False 


if EXPECT SUBSTRING not in res: ### 全 文 检索 


274 尺 Python Web 自动 化 测试 设计 与 实现 


PASS = False 


if not re.search (EXPECT REGEX, res): ## 正则 查询 
PASS = False 


if PASS: 

print "success'" 
else: 

print "failure' 


接着 来 看 看 如 何 对 XML 格式 的 响应 内 容 进行 验证 。 当 然 也 可 以 使 用 上 面 讲 到 的 三 种 普 
通 处 理 方式 ,但 这 并 不 是 最 优 的 ， 因 为 XML 是 一 个 结构 化 的 语言 ， 可 以 支持 结构 化 的 解析 
和 查询 ， 通 过 这 个 特性 可 以 对 XML 文档 进行 特定 路 径 内 容 的 查询 和 验证 。 具 体 而 言 ， 就 是 
利用 XPATH 进行 XML 文档 查询 ， 再 对 查询 到 的 内 容 进行 常规 验证 。 例 如 ， 响 应 体 的 内 容 为 
如 下 XML。 

<?xml Version="1.0" encoding="UTF-8"?> 

<product> 

<name>Caffe</name> 
<price>20</price> 


<num>20</num> 
</product> 


假设 需要 验证 商品 的 价格 为 209， 则 先 使 用 XPATH 把 price 节点 给 定位 到 ， 再 获取 该 节 
点 的 文本 内 容 ， 验 证 其 文本 是 否 为 20。 具 体 的 代码 验证 操作 如 以 下 代码 所 示 。 


#!/usr/bin/env Python 
dng VCE = 
import requests 

import lxml .etree 


EXPECT_PRICE = '20' 
res = requests.get ("http://www.XXmail.com/product?id=100") .上 text 


root = lxml .etree.HTML (res) 
nodes = root.xpath(u"//product/price") 


if nodes and nodes [0] .text == EXPECT PRICE: 
Print 'success' 

else: 
print "failure' 


上 面 代码 中 使 用 lxml 库 ， 它 可 以 直接 支持 XPATH 查询 XML 节点 并 获取 节点 的 文本 内 
; 如 果 本 机 没有 安装 lkml， 可 以 通过 如 下 命令 来 进行 安装 。 


pip install lxml 


识 
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如 果 对 XPATH 还 不 是 很 了 解 ， 建 议 先 学 习 XPATH 定位 相关 知识 。 

最 后 再 看 看 如 何 验证 JSON 格式 的 响应 内 容 。 同 XML 格式 一 样 ，JSON 格式 也 是 结构 
化 的 数据 ， 所 以 同样 可 以 通过 工具 包 很 方便 地 提取 指定 路 径 的 信息 。 好 比 XML 有 XPATH 一 
样 ，JSON 有 JSONPATH， 通 过 安装 JSONPATH 相关 的 Python 库 ， 就 可 以 通过 JSONPATH 
提取 信息 ， 这 里 使 用 的 是 jsonpath 库 ， 具 体 的 安装 命令 如 下 。 


pip install jsonpath 


关于 JSONPATH 的 语法 可 以 参见 http://goessner.net/articles/JsonPath/ 的 介绍 ， 这 里 演示 
下 如 何 结合 jsonpath 对 JSON 格式 的 响应 体 进行 验证 。 假 设 请 求 响应 体内 容 如 下 。 
{ 


"product": [ 


"name": "Caffe", 
"price"s "20 
"num": "20 


同样 需要 验证 商品 的 价格 为 20， 则 具体 的 验证 代码 见 如 下 代码 。 


#!/usr/bin/env python 
LN VEE-0 =# 
import requests,json 

from jsonpath import jsonpath 


EXPECT_PRICE = '20' 


res = requests.get ("http://xmail.com/product?id=100") .text 
nodes = jsonpath (json.loads (res), '$.product[*] .price') 


if nodes and nodes[0] == EXPECT PRICE: 
print 'success' 

else: 
print 'failure' 


上 述 代 码 中 ，'$.product[*].price' 就 是 JSONPATH 的 语法 。$ 代表 根 对 象 ，. 用 来 取 字典 
对 象 的 属性 ，[] 用 来 取 数 组 对 象 的 成 员 ，* 表示 获取 所 有 数组 的 所 有 成 员 。 假 如 只 取 第 一 个 
商品 的 价格 ， 则 JSONPATH 为 '$.product[0].price'。 

通过 本 介绍 ， 了 解 了 HTTP 响应 内 容 可 以 检查 的 对 象 ， 针 对 不 同 的 对 象 使 用 不 同 的 验证 
方式 ,不 同 的 内 容 使 用 不 同 的 策略 验证 。Web API 验证 相关 的 内 容 先 介绍 到 这 里 ， 接 下 来 继 
续 介 绍 Web API 自动 化 测试 的 其 他 知识 点 。 


276 ” 聊 Python Web 自动 化 测试 设计 与 实现 


12.5 多 线程 发 送 请 求 


到 目前 为 止 ， 已 经 可 以 学 习 了 如 何 使 用 Python 发 送 一 个 特定 的 HTTP 请 求 ， 并 且 对 响 
应 内 容 进 行 指定 的 验证 。 假 设 现在 有 一 个 需求 是 持续 不 断 地 发 送 很 多 HTTP 请 求 ， 最 简单 的 
实现 方法 是 设 定 一 个 循环 ， 然 后 在 循环 内 重复 地 发 送 HTTP 请 求 。 再 假设 我 们 希望 在 单位 时 
间 内 尽 可 能 多 地 发 送 HTTP 请 求 ， 那 么 此 时 就 可 以 使 用 多 线程 来 发 送 请 求 了 。 

多 线程 的 设计 目的 是 提高 CPU 的 使 用 率 ， 让 CPU 在 执行 任务 时 能 够 尽 可 能 达到 饱和 状 
态 。 原 理 是 当 某 个 线程 在 执行 任务 时 有 CPU 等 待 操作 (如 IO、 网 络 等 )， 其 他 线程 就 可 以 获 
得 CPU 的 执行 权 并 进行 任务 的 执行 ， 不 让 CPU 有 空闲 时 间 。 在 向 Web API 发 送 HTTP 请 求 
时 ， 单 个 任务 执行 中 就 有 网 络 的 等 待 操作 (有 的 也 会 有 磁盘 IO 操作 )， 所 以 CPU 在 执行 任务 
过 程 中 就 有 了 空闲 时 间 ， 使 用 多 线程 就 可 以 刚好 发 挥 其 作用 。 

从 理论 上 讲 多 线程 可 以 在 单位 时 间 内 发 送 更 多 的 HTTP 请 求 ， 接 下 来 将 介绍 使 用 多 线程 
编程 来 发 送 HTTP 请 求 。 在 Python 中 要 实现 多 线程 有 两 种 方式 ， 一 种 是 函数 方式 ， 另 一 种 是 
类 继承 的 方式 ， 接 下 来 分 别 具 体 看 看 如 何 实 现 。 


12.5.1 ”函数 式 多 线程 


在 Python 中 实现 函数 式 多 线程 是 通过 Thread 方法 来 实现 的 ， 接 下 来 看 看 如 下 代码 中 的 
使 用 方式 。 


#!/usr/bin/env Python 
1 
import time, threading 


def foo (name) : 
thread name = threading.current thread() .name 
print 'start thread %s with args %s' % (thread name, name) 
time.sleep (1) 
print 'end thread %s ' $% thread name 


print 'thread %s is running...' % threading.current thread() .name 
t = threading.Thread (target=foo0, args=('hello python',)) 
t.start () 

t.join() ## 阻塞 主 进程 


print 'thread %s ended.' % threading.current thread() .name 


代码 中 使 用 threading.Thread 类 来 实例 了 一 个 新 的 线程 ， 该 方法 的 target 参数 接收 的 是 一 
个 需要 被 子 线程 执行 的 函数 名 ， 而 args 参数 则 是 执行 函数 时 所 需要 的 参数 内 容 ; 启动 线程 时 
需要 通过 start() 方法 来 启动 ， 同 时 需要 通过 join 方法 来 使 主线 程 等 待 子 线程 的 执行 ， 否 则 主 
线程 可 能 会 早 于 子 线程 结束 。 上 述 代码 的 运行 结果 如 下 所 示 。 


第 12 章 Python 发 送 HITP 请 求 & 277 


thread MainThread is running... 

start thread Thread-1l with args hello Python 
end thread Thread-1 

thread MainThread ended. 


从 执行 结果 中 也 验证 了 代码 逻辑 ， 默 认 情况 下 Python 会 有 一 个 主线 程 (MainThread) 来 
执行 代码 ， 当 新 建 一 个 线程 的 时 候 就 会 产生 一 个 子 线程 ， 而 通过 join 方法 使 得 主线 程 一 直 在 
等 待 子 线程 的 执行 结束 。 

来 看 下 如 何 使 用 多 线程 发 送 Web API 请 求 ， 首 先 得 有 一 个 发 送 API 请 求 的 任务 列 


现在 再 
表 ， 列 表 里 都 是 需要 依次 发 送 的 API 请 求 和 数据 ， 这 里 假设 API 请 求 列表 内 容 如 下 。 
API LIST = [ 
{ 
"url" : "http://httpbin.org/get", 
"method" : "get", 
ndatan s 1 
"username" : "admin", 
"password" : "changeit" 
} 
bl 
"url" : "http://httpbin.org/post", 
"method" : "post", 
"data" : { 
"username" : "admin", 
"password" : "changeit" 


] 
默认 情况 下 使 用 单线 程 执 行 上 述 API 请 求 列表 时 ， 使 用 的 代码 内 容 如 下 所 示 。 


#!/usr/bin/env Python 

# -*- coding: utf-8 -*- 
import requests 

from APILIST import API_LIST 


def loop apis (API_LIST) : 
for api data in API_LIST: 
call api(api_data) 


def call api(lapi data): 
url = api data['url'] 
method = api data['method'] 
payload = api data[l'data'] 


if method=='get': 
r= requests.get (url, params=payload) 
elif method=="'post': 
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r= requests.post (url, data=payload) 


code = r.status code 
it code == 200: 
print 'success' 
else: 
print "failure' 
if name =="' main _': 
loop_apis (API LIST) 


上 述 代码 中 执行 任务 列表 的 只 有 Python 默认 的 主线 程 (MainThread)， 如 果 要 使 用 多 线 
程 来 执行 ， 则 只 需 修改 过 _ name _ 一 ' main "; 语句 下 的 代码 内 容 即 可 ， 修 改 为 多 线程 后 
的 代码 见 如 下 代码 。 


if name == ' main ': 
THREAD NUM = 2 ## 需要 启动 的 线程 数 
STEP = 1 ## 单线 程 执行 的 任务 量 ， 默 认为 1 


API_LEN = len(API_LIST) 


if API_LEN < THREAD NUM: 
THREAD NUM = API_LEN 
else: 
STEP = API_LEN / THREAD NUM 
if API_LEN % THREAD NUM != 0: 
STEP += 1 


index = 0 

sub api_ list = [] 

while index+STEP <= API_LEN: 
sub api_list.append(tuple (API LIST[index: index+STEP])) 
index += STEP 


if index < API_LEN: 
sub api_ list.append(tuple(API LIST[index:])) 


thread list = [] 

for sub api in sub api list: 
t = threading.Thread (target=loop_apis, args=(sub_api,)) 
t.start() 
thread list.append(t) 


for t in thread list: 
L150et} 


上 述 代码 中 真正 与 多 线程 有 关 的 代码 只 有 三 行 ， 而 前 面 代 码 所 做 的 工作 主要 是 为 了 给 多 
线程 平均 分 配 任务 ; 代码 会 根据 设 定 的 线程 数 和 具体 的 任务 数量 ， 来 计算 单个 线程 的 任务 量 ; 
最 后 一 次 性 启动 所 有 线程 并 阻塞 主 进程 。 


I 
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12.5.2 ”类 继承 式 多 线程 


类 继承 式 多 线程 与 函数 式 多 线程 在 执行 任务 的 效果 上 是 一 致 的 ,但 由 于 类 继承 式 多 线程 
是 通过 继承 threading.Thread 类 来 实现 的 ， 因 此 在 定制 化 和 可 操作 性 上 要 更 加 原生 。 可 以 先 
通过 如 下 代码 了 解 其 实现 方式 。 

#!/usr/bin/env python 


# -*- coding: utf-8 -*- 
import time, threading 


class Foo (threading.Thread) : 
def _ init_ (self, name): 
super (Foo, self)._init _() 
self.name = name 


def run(self) : 
thread_name = threading.current_thread() .name 
print "start thread %s with args %s' % (thread name, self.name) 
time.sleep (1) 
Print "end thread %s ' $ thread name 


print 'thread %s is running...' % threading.current thread() .name 
t = Fool('hello python') 

七 .stat () 

t.join() 


print 'thread %s ended.' % threading.current thread() .name 


代码 中 新 建 了 一 个 继承 自 threading.Thread 类 的 子 类 ， 并 重 写 了 父 类 中 的 run 方法 ， 随 后 
通过 实例 这 个 子 类 来 创建 一 个 子 线程 。 上 述 代码 执行 后 与 单线 程 时 的 效果 一 致 。 

同样 ， 也 可 以 把 代码 修改 为 发 送 API 请 求 ， 主 要 是 通过 修改 代码 中 的 run 方法 内 容 来 实 
现 ， 具体 见 如 下 代码 。 


#!/usr/bin/env python 
Goding: WS-8 = 
import threading 

import requests 

from APILIST import API_LIST 


class CallAPI (threading.Thread): 

def _ init (self, api list): 
super (CallAPI, self)._init __() 

self.api list = api list 


def runl(self): 
for api data in api list: 


self. call api (api data) 


def _call api_ (self, api data): 
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url = api_data['url'1] 
method = api data['method'] 
payload = api data[l'data'] 


if method == 'get': 
r= requests.get (url, params=payload) 
elif method == 'post': 


r= requests.post(url, data=payload) 


code = r.status_code 
if code == 200: 
print "Success' 
else: 
print 'failure' 


if name ==" main _': 
t = CallAPI (API_LIST) 
七 .Start () 
t.join() 


上 述 代码 的 执行 结果 与 单线 程 时 效果 一 致 ， 而 如 果 需 要 把 代码 改进 为 多 线程 执行 ， 同 样 
只 需 修改 让 _name “一 _ main :下 的 代码 内 容 即 可 。 修 改 后 的 内 容 如 下 所 示 。 


if _ name == '_main_': 
THREAD NUM = 2 ## 需要 启动 的 线程 数 
STEP = 1 ## 单线 程 执行 的 任务 量 


API_LEN = len(RAPI_LIST) 


if API_ LEN < THREAD NUM: 
THREAD NUM = API_LEN 
else: 
STEP = API_LEN / THREAD NUM 
if API LEN % THREAD NUM ! 
STEP += 1 


index = 0 

sub api list = [] 

while index+STEP <= API_LEN: 
sub_api_list.append (tuple (API_LIST[index: index+STEP])) 
index += STEP 


if index > API_LIST: 
sub api list.append(tuple(API LIST[index - STEP:])) 


thread list = [] 

for sub api in sub api list: 
t = CallAPI (sub api) 
t.start() 
thread list.append(t) 
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for t in thread list: 
t.join() 


上 述 代 码 只 有 线程 调用 的 代码 不 同 ， 其 他 逻辑 都 是 相同 的 ， 最 后 执行 的 效果 也 是 一 
致 的 。 


CHAPTER 


13 ri Irieitsam 


在 前 面 的 章节 中 对 Web API 进行 了 相关 介绍 ， 并 且 对 Web API 的 测试 技术 和 方法 进行 了 
介绍 。 针 对 Web API 的 测试 ， 其 实 就 是 对 Web 接口 的 调用 和 验证 的 过 程 。 它 不 像 UI 测试 一 
样 需要 单 击 和 操作 界面 ， 针 对 不 同 的 业务 场景 需要 不 同 的 操作 步骤 ，Web API 的 测试 步骤 基 
本 都 是 一 致 的 ， 所 以 它 非 常 适合 使 用 标准 化 的 工具 进行 测试 。 

目前 市 面 上 针对 Web API 测 试 的 工具 也 有 很 多 ， 例 如 ，SoapUI、Postman、JMeter 等 。 
针对 常规 的 Web API 测 试 需求 ， 可 以 直接 使 用 现 有 的 Web API 测试 工具 ， 但 事情 往往 并 没有 
按照 希望 的 那样 发 展 ， 有 时 候 可 能 需要 一 些 定制 化 的 需求 。 例 如 ， 用 例 数据 统一 管理 、 用 例 
权限 管理 ， 而 现 有 的 工具 可 能 没有 提供 ， 此 时 就 需要 自己 开发 一 些 API 测试 工具 ， 本 章 就 开 
始 介 绍 如 何 使 用 Python 来 开发 一 个 通用 的 API 测试 工具 。 


13.1 最 简单 的 API 工具 


在 此 之 前 对 API 工具 的 设计 与 开发 已 经 做 了 很 多 的 铺垫 ， 例 如 ，API 测试 的 流程 、API 
请 求 的 发 送 、API 结果 的 验证 等 ， 所 以 很 容易 发 现 ， 其 实 把 前 面 章 节 介 绍 过 的 知识 点 集合 到 
一 起 就 是 一 个 简单 的 API 测试 工具 。 

首先 看 一 个 最 简单 的 API 测试 工具 样 例 ， 随 后 基于 这 个 样 例 工具 进行 功能 拆 分 和 需求 完 
善 ， 逐 步 完 成 一 个 易 用 的 API 测试 工具 。 样 例 工具 的 代码 参见 如 下 代码 。 


#!/usr/bin/env python 
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= codings: SEE 一 8 == 
import requests, sys 


def demo(url, encoding="'utf-8°'): 
rsp = requests.get (url) 
rsp.encoding = encoding 
code = rsp.status code 
txt = rsp.text 
return code, txt 


if name ==" main _';: 
print demo('https://github.com/timeline.json') 


上 述 代码 实现 的 API 功能 非常 简单 ， 相 当 于 一 个 没有 界面 的 浏览 器 功能 。 它 只 支持 一 种 
GET 请 求 ， 并 且 只 接收 请 求 URL 和 可 选 的 响应 内 容 编码 两 个 参数 。 运 行 该 代码 前 只 需要 修 
改 下 URL 和 必要 的 编码 格式 即 可 ， 和 运行 之 后 在 命令 行 中 会 回 显 响应 代码 和 响应 内 容 。 把 上 
述 代 码 的 内 容 保存 到 文件 demo_api.py 中 ， 在 命令 行 运行 效果 如 图 13-1 所 示 。 


图 13-1 最 简单 的 API 工具 


在 偶尔 使 用 一 次 的 情况 下 ， 可 以 通过 修改 代码 中 的 URL 来 访问 不 同 的 API。 但 是 ， 如 
果 经 常 性 地 使 用 并 且 需 要 访问 不 同 的 API 地址， 直接 使 用 代码 可 能 就 不 太 方便 。 此 时 只 需要 
对 代码 进行 一 处 小 的 改动 就 可 以 解决 这 个 问题 。 具 体 改 动 的 代码 为 “main “条 件 以 下 的 部 
分 ， 修 改 后 的 代码 参见 如 下 代码 。 


if _name == ' main _': 

arg_len = lenl(sys.argv) 

if arg len == 1: ## 没有 参数 
print ' 缺少 请 求 url 参数 ' 
exit (1) 

elif arg_Ien == 2: 
code, txt = demol(sys.argv[1]) 

else: 
code, txt = demo(sys.argv[1], sys.argv[2]) 
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Print code 
print txt 


新 的 代码 中 会 直接 从 命令 行 来 获取 请 求 URL 和 编码 ， 这 样 每 次 运行 代码 时 只 要 附带 上 
对 应 的 参数 即 可 ， 而 无 须 再 修改 代码 内 容 。 新 代码 的 运行 效果 如 图 13-2 所 示 。 


AWindows\system32\cmd.exe 加 
国 CWindows\system3Z\emd. i 和 


图 13-2 通过 命令 行 获取 API 请求 URL 
现在 就 可 以 利用 这 个 简单 的 API 工具 来 访问 用 户 的 API， 当 然 目 前 只 能 访问 接受 GET 
方法 的 API， 如 果 需 要 访问 支持 其 他 方法 的 API， 那 就 继续 往 下 看 吧 ! 


13.1.1 请 求 方法 设置 


前 面 实 现 了 一 个 非常 简单 的 API 工具 ， 虽 然 可 以 访问 API， 但 是 却 只 能 支持 GET 方法 
的 请 求 ， 如 果 想 要 支持 更 多 的 请 求 方法 ， 就 需要 对 代码 功能 进行 扩展 ， 本 节 介绍 如 何 支持 更 
多 的 请 求 方法 。 

在 前 面 代码 中 只 实现 了 GET 方法 的 调用 ， 所 以 ， 如 果 想 支持 更 多 的 方法 ， 则 需要 在 代 
码 中 实现 对 应 请 求 方法 的 调用 。 例 如 ， 对 POST 方法 提供 支持 ， 则 要 在 代码 中 实现 POST 方 
法 的 调用 ， 对 PUT 方法 提供 支持 ， 则 需要 代码 中 实现 PUT 方法 的 调用 。 代 码 的 主要 方法 可 
以 直接 修改 成 如 下 所 示 。 


def demo (ur1，method='get'，data=None，encoding='utf-8') : 
if method.lower() == 'get': 
rsp = requests.get (url, params=data) 
elif method.lower() == 'post': 
rsp = requests.post (url, data) 
elif method.lower() == 'put': 
rsp = requests.put (url, data) 
rsp.encoding = encoding 
code = rsp.status_ code 
txt = rsp.text 
return code, txt 
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这 里 把 原来 的 主 方法 进行 了 修改 ， 修 改 后 的 主 方法 增加 了 一 个 method 参数 ， 主 要 用 来 
指定 使 用 哪 种 请 求 方法 ; 同时 还 增加 了 一 个 data 参数 ， 用 来 指定 请 求 需要 发 送 的 数据 ; 之 后 
的 代码 会 根据 method 参数 进行 判断 ， 并 调用 对 应 的 请 求 方法 函数 。 

从 功能 上 来 讲 ， 上 述 代 码 已 经 实现 了 支持 多 种 请 求 方法 ， 作 为 样 例 只 支持 三 种 请 求 方 
法 ， 而 实际 上 可 以 选择 支持 更 多 的 请 求 方法 。 最 简单 的 实现 方式 就 是 继续 增加 计 语 句 判断 ， 
但 是 这 样 会 造成 让 语句 过 多 而 导致 代码 可 读 性 很 差 .尤其 是 在 增加 的 请 求 方法 很 多 的 情况 
下 ， 所 以 可 以 对 代码 再 进行 一 次 优化 ， 新 的 代码 如 下 。 


def demol(url, method='get', data=None, encoding='utf-8'): 
method = method.strip() .lower() \ 
if method and isinstance (method, str) else 'get' 
if hasattr (requests, method): 
func = getattr (requests, method) 
if method in ['post', 'put', 'patch']: 
rsp = func(url, data) 
else: 
rsp = funcl(url, params=data) 
else: 
rsp = requests.get (url, params=data) 
rsp.encoding = encoding 
code = rsp.status_code 
txt = rsp.text 
return code, txt 


这 次 更 新 后 对 method 参数 进行 了 验证 ， 如 果 无 效 或 不 合法 都 会 被 设置 成 默认 的 GET 请 
求 方法 ; 而 如 果 method 参数 有 效 ， 则 会 从 requests 对 象 中 获取 其 对 应 的 请 求 发 送 函 数 ; 并 且 
这 里 对 请 求 方法 进行 了 分 类 ，POST、PUT、PATCH 可 以 支持 body 发 送 请 求 数据 的 为 一 类 ， 
其 他 方法 为 男 一 类 ， 这 两 类 在 函数 调用 的 参数 使 用 上 有 区 别 。 

新 代码 更 新 之 后 ， 我 们 的 调用 方式 也 需要 同步 更 新 ， 新 的 调用 示例 见 如 下 代码 。 


if _name =='_ main ，: 
code, txt = demo("http://httpbin.org/post", 
Pot"y KL vi 
print code 
print txt 


提示 。 http://httpbin.org/post 是 一 个 镜像 API， 专 门 用 来 接收 POST 请 求 并 回 显 请 求 所 发 
送 的 数据 ， 常 用 于 HTTP 请 求 的 调试 ， 同 类 型 的 还 有 GET、PUT 等 其 他 方法 的 镜像 接口 。 


运行 新 代码 之 后 的 返回 结果 如 图 13-3 所 示 。 
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图 13-3 POST 方式 请 求 API 
到 这 里 读者 可 能 会 发 现 ， 之 前 可 以 通过 命令 行 指定 URL 参数 ， 那 么 现在 是 不 是 可 以 通 
过 命令 行 指定 请 求 方法 和 数据 呢 ? 答案 是 肯定 的 。 当 然 我 们 也 需要 对 命令 行 参数 接收 部 分 的 
代码 进行 相应 的 更 新 ， 更 新 之 后 就 可 以 同时 支持 请 求 URL、 请 求 方法 、 请 求 数据 、 编 码 格式 
等 参数 。 具 体 代码 如 下 。 


BE ME 
usage = 'Usage: \r\n\t' \ 
'%s -u http://www.baidu.com -m get' % sys.argv[0] 
opts, args = getopt.getopt(sys.argv[1:], "hu:m:d:e:") 


url = method = data = encoding = None 
for op, value in opts: 


if op == "-u": 
url = value 
elif op == "-m": 
method = value 
elif op == '-d': 
data = value 
elif op == '-e': 
encoding = value 
elif op == "-h": 
print usage 
sys.exit() 


if url and method: 
code, txt = demo(url, method, data, encoding 
print code 
print txt 
else: 
print usage 


由 于 这 次 需要 接收 的 参数 比较 多 ， 所 以 直接 使 用 getopt 模块 来 解析 命令 行 参数 ， 它 会 根 
据 设 定 的 参数 进行 解析 ， 这 里 只 设 定 了 请 求 URL ( -u)、 请 求 方法 (-m)、 请 求 数据 (-d)、 编 
码 格式 (-e)、 使 用 帮助 (-h) 5 个 参数 的 解析 ; 在 解析 完成 之 后 就 可 以 对 参数 进行 获取 和 验证 ， 
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最 后 使 用 接收 到 的 参数 进行 主 方法 调用 。 
上 述 代码 的 运行 效果 如 图 13-4 所 示 。 


图 13-4 POST 发 送 JSON 数据 

通过 比较 图 13-3 和 图 13-4 可 以 发 现 ， 虽 然 表 面 上 看 两 次 请 求 所 发 送 的 数据 内 容 是 一 样 
的 ， 但 是 在 回 显 内 容 里 数据 被 显示 在 不 同 区 域 ; 这 是 因为 通过 命令 行 传递 过 去 的 参数 默认 是 
字符 串 类 型 ， 而 在 前 述 代 码 中 传递 的 则 是 一 个 字典 对 象 。 所 以 需要 把 命令 行 接收 到 的 数据 参 
数 进行 一 次 转换 ， 从 字符 串 类 型 转 成 字典 类 型 。 具 体 转 换代 码 如 下 。 


elif op == '-d': 
try: 
data = json.loads (value) 
except Exception, ex: 
data = value 


在 命令 行 重新 执行 一 次 脚本 ， 运 行 后 的 结果 如 图 13-5 所 示 。 


IE 


图 13-5 POST 发 送 普通 form 数据 
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新 的 运行 结果 中 请 求 数据 的 回 显 位 置 与 图 13-3 已 经 一 致 了 , 但 同时 也 会 发 现 命令 行 发 
送 数据 时 也 进行 了 格式 的 修改 ， 这 是 为 了 满足 JSON 格式 和 对 双 引 号 进行 转 义 。 另 外 ， 图 
13-5 与 图 13-4 相 比 还 多 了 一 个 Content-Type 请 求 头 ， 这 是 requests 模块 自动 添加 的 ， 而 如 果 
想 要 主动 添加 请 求 头 该 怎么 实现 呢 ? 答案 请 见 13.1.2 节 。 


13.1.2 ”请 求 头 设置 

通常 情况 下 不 会 对 请 求 头 做 过 多 的 设置 ， 只 有 在 某 些 特定 场景 下 ， 才 会 做 一 些 请 求 头 设 
置 。 例 如 ，API 只 接收 JSON 格式 的 请 求 数据 ， 那 么 就 需要 把 Content-Type 设 为 application/ 
json。 本 节 就 来 介绍 下 如 何 让 我 们 的 API 工具 支持 请 求 头 的 设置 。 

请 求 头 相对 于 请 求 方法 更 容易 设置 ， 因 为 请 求 头 的 设置 不 需要 区 分 请 求 类 型 ， 所 有 的 请 
求 方式 对 请 求 头 的 设置 都 是 一 样 的 。 我 们 唯一 需要 做 的 就 是 ， 在 运行 程序 的 时 候 把 请 求 头 内 
容 传递 进去 ， 然 后 在 主 方法 中 把 接收 到 的 请 求 头 发 出 去 即 可 。 

首先 ， 需 要 添加 一 个 接收 请 求 头 内 容 的 参数 ， 由 于 -h 已 经 用 于 使 用 帮助 了 ， 因 此 这 里 
请 求 头 的 参数 可 以 设 定 为 -H。 为 此 还 需要 更 改 与 参数 接收 相关 的 代码 ， 具 体 见 如 下 代码 。 


opts，args = getopt.getopt(sys.argv[1:]，"hu:m:d:e:H:") 
headers = {} 


elif op == '-H': 
try: 
headers.update (json.loads (value)) 
except Exception, ex: 
print 'ERROR: headers format error' 
sys.exit (1) 


code, txt = demol(url, method, data, headers, encoding) 


该 部 分 代码 的 主要 功能 是 增加 -了 H 参数 来 接收 请 求 头 内 容 ， 同 时 还 需要 把 请 求 头 内 容 传 
递 给 主 方法 ， 因 此 主 方法 的 定义 也 需要 进行 修改 ， 关 键 部 分 的 代码 修改 如 以 下 代码 所 示 。 


def demo(url, method='get', data=None, 
headers=None, encoding='utf-8°'): 


rsp = func(url, data, headers=headers) 
else: 
rsp = func(url, params=data, headers=headers) 
else: 
rsp = requests.get (url, params=data, headers=headers) 


主 方法 中 添加 了 一 个 接收 请 求 头 的 参数 headers， 并 且 在 三 处 调用 具体 请 求 方法 的 代码 
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行 中 相应 地 添加 了 headers 参数 的 传递 ; 再 次 执行 修改 后 的 代码 ， 其 效果 如 图 13-6 所 示 。 


xe ca 


dows\system32\o 


图 13-6 ”请求 头 设置 


可 以 看 到 请 求 头 Referer 已 经 被 发 送 成 功 ， 而 如 果 希 望 同时 设置 多 个 请 求 头 信息 时 该 怎 
么 办 呢 ? 答案 是 使 用 多 次 -HH 参数。 例如， 同时 设置 referer 和 user-agent 请 求 头 信息 时 ， 其 
执行 命令 与 结果 如 图 13-7 所 示 。 


国 C\Windows\system32\cmd.exe eel)| i 


图 13-7 多 请 求 头 设置 


目前 关于 请 求 头 设置 的 内 容 已 经 介绍 完 。 这 里 只 是 简单 介绍 从 命令 行 来 获取 请 求 头 信 
息 ， 在 后 面 的 章节 会 把 所 有 的 请 求 信息 都 提取 到 配置 文件 当中 ， 如 果 读 者 对 这 部 分 内 容 感 兴 
趣 ， 可 以 直接 查阅 相关 章节 。 


13.1.3 ”支持 文件 上 传 
在 之 前 的 章节 中 已 经 提 到 过 multipart/form-data 类 型 的 POST 请 求 ， 其 实 这 种 类 型 的 请 
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求 主要 用 来 传输 文件 到 服务 器 端 。 无 论 是 Web 页 面 上 还 是 Web API 中 经 常 都 会 有 文件 上 传 的 
需求 ， 所 以 对 于 文件 上 传 功能 的 支持 是 一 个 Web API 工 具 的 基本 属性 。 本 节 就 来 给 API 工具 
添加 文件 上 传 的 功能 。 

文件 上 传 功能 相对 于 普通 的 请 求 数据 要 稍微 复杂 点 儿 ， 为 了 不 与 普通 的 请 求 数据 混淆 概 
念 ， 我 们 需要 使 用 单独 的 参数 来 接收 文件 内 容 ， 这 里 就 使 用 files 参数 。 这 个 files 参数 是 一 个 
列表 对 象 ， 列 表 的 每 一 个 子 项 都 是 一 个 元 组 对 象 ， 代 表 multipart/form-data 数据 的 一 个 区 块 。 
元 组 子 项 的 内 容 分 别 由 字段 名 、 文 件 路 径 、 文 件 类 型 组 成 ， 其 完整 格式 如 下 所 示 。 


[ 


('images', '/path/to/image.jps', ‘'image/jpg'), 
('images', '/path/to/image2.jps', 'image/jpg'), 
('file', '/path/to/file.txt', 'text/plain') 


] 


在 接收 到 files 参数 之 后 ， 会 遍历 files 列表 并 对 其 进行 重新 组 装 ， 然 后 在 发 送 请 求 的 时 
候 一 并 发 送 给 服务 器 端 。 关 于 主 方法 中 的 代码 修改 如 下 所 示 。 


def demo(url, method='get', data=None, 
headers=None, files=None, encoding='utf-8°'): 


if method in ['post', 'put', ‘'patch']: 
multiple files = [] 
if files: 
multiple files = warp files (files) 
rsp = func(url, data, headers=headers, 
files=multiple files) 


def warp files (files): 
multiple files = [] 
for ft in files: 
if not isinstance (ft, tuple): 
raise TypeError, "文件 子 项 不 是 元 组 类 型 " 
if len(ft) < 2 or len(ft) > 3: 
raise ValueError，" 文件 子 项 长 度 错误 " 


fisld = Ft[0] 
file path = ft[1] 
file_ name = os.path.basename (file_path) 
2 Lentrt) == 3 
mime = ft[2] 
else: 
mime = mimetypes.guess_type (file_path) [0] 


t= (field, (file name, open (file path, 'rb'), mime)) 
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multiple files.append (t) 


return multiple files 
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通过 分 析 代 码 后 可 以 知道 ，demo 方法 已 经 添加 了 一 个 files 参数 ， 并 且 对 这 个 files 对 象 
解析 重组 的 过 程 已 经 被 提取 到 warp_files 方法 中 ; 在 warp_files 方 法 中 先 对 files 对 象 的 子 项 
进行 了 类 型 判断 ， 如 果 类 型 正确 就 开始 对 其 子 项 进行 拆 分 和 重组 ， 然 后 返回 重组 后 的 新 列表 


对 象 ; 最 后 主 方法 在 发 送 请 求 时 附带 上 了 重组 后 的 列表 对 象 。 


demo 方法 修改 完成 之 后 还 要 继续 做 一 件 事 ， 那 就 是 从 命令 行 接收 对 应 参数 。 这 里 用 -f 
命令 行 参数 来 接收 待 发 送 文件 的 信息 ，-f 参 数 的 格式 为 field:path:mimetype， 例 如 : 


demo api.py -u url -m post -f file:1.jpg:image/jpg 
最 后 根据 -f 的 参数 格式 进行 相应 解析 。 关 于 -f 参 数 的 解析 见 如 下 代码 。 


def parse args (usage): 
opts, args = getopt.getopt(sys.argv[1:], "hu:m:d:e:H:f:") 


files = [] 
for op, value in opts: 
elif op == '-f': 
t = tuple(value.split(':')) 


files.append (t) 


return { 


237 % Ply 

"method' : method, 
"data' : data, 
"encoding' : encoding, 
'files' : files, 
'headers' : headers 


这 里 已 经 把 命令 行 参数 解析 相关 的 代码 提取 到 了 独立 的 方法 中 ， 并 且 添 加 了 -参数 的 接 
收 与 解析 代码 。 具 体 为 把 -f 的 参数 内 容 以 : 分 隔 ， 并 转换 为 元 组 类 型 再 追加 到 files 列表 对 象 


中 ， 即 组 装 成 刚 开 始 定义 的 主 方法 中 的 files 参数 的 形式 。 


保存 好 修改 后 的 代码 ， 在 命令 行 执行 下 带 -参数 的 API 请 求 ， 效 果 如 图 13-8 所 示 。 


从 图 中 可 以 看 到 Content-Type 已 经 是 multipart/form-data 类 型 ， 并 且 files 
了 响应 的 内 容 。 


区 域 已 经 


回 显 


提示 执行 参数 的 时 候 注 意 文件 路 径 一 定 要 正确 ， 可 以 是 相对 路 径 ， 但 最 好 是 填写 绝 
对 路 径 。 如 果 文 件 路 径 中 包含 空格 ， 则 直接 用 双 引 号 把 -f 参 数 的 值 都 给 括 起 来 ; 如 果 需 要 上 


传 多 个 文件 ， 只 要 添加 多 个 二 参数 即 可 。 
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画 cvwindowsvsystem32vcmd.exe kt. 


图 13-8 ”发 送 请 求 文件 
13.1.4 ”简单 结果 验证 


目前 为 止 我 们 已 经 可 以 通过 自 定义 的 API 工具 来 访问 大 多 数 API， 基 本 上 日 常 工 作 中 常 
见 的 API 都 可 以 通过 该 工具 来 进行 访问 和 回 显 内 容 ; 但 作为 一 个 真正 的 API 测试 工具 而 言 
这 还 不 够 ， 因 为 它 不 具有 验证 结果 的 能 力 。 所 以 本 节 为 API 工具 添加 一 个 简单 的 结果 验证 功 
能 ， 让 它 成 为 一 个 基本 完整 的 API 测试 工具 。 

在 前 面 的 工具 使 用 过 程 中 ， 都 是 直接 把 响应 内 容 回 显 在 命令 行 中 ， 而 没有 进行 任何 的 检 
查 操作 ; 为 了 给 工具 添加 结果 验证 功能 ， 可 以 把 响应 内 容 作为 验证 对 象 ， 并 且 它 也 是 我 们 日 
常 API 测 试 时 的 重点 验证 对 象 。 

在 12.4 节 已 经 介绍 过 关于 响应 内 容 的 验证 方法 ， 这 里 就 选用 最 简单 的 方法 一 一 全 文 检索 
模式 ， 集 成 到 API 工具 中 。 如 下 代码 是 结果 验证 的 新 增 方 法 。 


def verify result(code, txt, expect): 

if code = 200: 
print ' 测试 失败 : 响应 代码 期 望 值 为 200， 实 际 为 '，code 
return False 

if expect not in txt: 
print ' 测试 失败 : 响应 内 容 期 望 包含 和 s， 实 际 未 包含 '， expect 
return False 

print ' 测试 通过 ， 


return True 
这 个 方法 中 同时 验证 了 响应 码 和 响应 内 容 ， 对 于 响应 码 默 认 只 验证 200 状态 ， 其 他 非 
200 状态 都 是 错误 的 。 而 对 于 响应 内 容 也 只 是 做 了 一 个 子 字符 串 查询 的 验证 。 相 对 而 言 实现 
逻辑 比较 简单 ， 但 至 少 API 工具 现在 有 了 验证 的 功能 。 关 于 集成 更 多 验证 方法 的 内 容 将 在 后 
面 章 节 中 介绍 。 
为 了 保证 这 个 验证 方法 能 够 被 正常 调用 ， 还 需要 把 期 望 验证 的 内 容 传递 给 该 函数 。 首 先 
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需要 从 命令 行 来 接收 期 望 结果 内 容 ， 然 后 传递 给 主 方法 ， 最 后 再 传递 给 上 述 代码 中 的 验证 方 
法 。 运 行 新 代码 后 的 效果 如 图 13-9 所 示 。 


筷 awndowssyser32emds 


13-9 ”验证 期 望 结果 


到 此 为 止 ， 自 定义 的 简单 API 工具 已 经 介绍 完毕 ， 完 整 的 工程 代码 详 见 GitHub 网 址 ， 
后 续 会 继续 以 这 个 API 工具 为 原型 来 进行 功能 的 扩展 与 升级 。 


13.2 ”测试 数据 读 取 


13.1 节 介绍 了 如 何 实现 一 个 最 简单 的 API 测试 工具 ， 这 个 工具 虽然 已 经 可 以 使 用 , 但 
是 在 功能 完备 性 和 易 用 性 方面 还 有 很 多 需要 完善 的 地 方 。 在 之 前 的 演示 中 都 是 通过 命令 行 来 
执行 的 ， 而 在 实际 测试 时 不 可 能 从 命令 行 逐 条 执行 ， 而 应 该 是 自动 读 取 提 前 准备 好 的 测试 数 
据 。 为 了 能 达到 这 一 效果 ， 本 节 将 介绍 如 何 给 API 工具 添加 一 个 测试 数据 读 取 的 功能 模块 。 

实现 数据 读 取 模块 的 设计 流程 主要 如 下 。 

(1 ) 设计 测试 工具 需要 的 数据 及 格式 。 

(2 ) 选 定 一 种 数据 存储 方式 ,例如 ， 文 本 存储 方式 (CSV、XML、JSON 等 )、DB 存储 
方式 (SQLite、MySQL、Mongo 等 )。 

(3 ) 结合 存储 方式 和 数据 格式 来 进行 功能 代码 的 实现 。 


13.2.1 测试 数据 格式 

关于 测试 数据 的 雏形 前 面 已 经 出 现 过 ， 即 我 们 在 命令 行 执行 时 的 参数 数据 ， 这 些 参数 中 
包括 请 求 URL、 请 求 方法 、 请 求 数据 、 请 求 头 、 请 求 文件 、 期 望 结果 等 API 测试 所 需 的 一 系 
列 数据 。 这 些 数据 已 经 可 以 满足 我 们 的 测试 所 需 ， 所 以 本 节 中 测试 数据 格式 就 以 这 一 雏形 数 
据 为 基础 进行 设计 。 

经 过 对 使 用 到 的 测试 数据 进行 一 个 简单 罗列 ， 可 以 得 到 一 个 如 表 13-1 所 示 的 测试 数据 


294 


六 ”Python Web 自动 化 测试 设计 与 实现 


格式 的 表格 。 
表 13-1 测试 数据 格式 
数据 字段 备注 
请 求 URL 必 选 
请 求 数据 可 选 
请 求 头 可 选 
请 求 文件 可 选 ,文件 路 径 
结果 检查 方式 必 选 
响应 编码 可 选 ， 默 认 utf-8 


从 表 13-1 中 可 以 看 到 ， 测 试 数据 字段 与 第 12 章 中 命令 行 参 数字 段 基本 保持 一 致 ， 可 以 


保障 大 多 数 情况 下 的 测试 需求 。 接 下 来 针对 每 一 个 数据 字段 分 别 介绍 其 格式 及 内 容 形式 。 


可 选 


口 请 求 URL: 需要 访问 的 API 地 址 ， 如 http://example.cn，https://github.com/timeline.json。 

口 请 求 方法 : 访问 API 的 方式 ， 如 GET、POST、PUT、PATCH 等 。 

口 请 求 数据 : 进行 POST、PUT 等 请 求 时 所 需要 发 送 的 数据 内 容 ， 如 { keyl : valuel， 
key2: value2}。 

口 请 求 头 : 发 送 请 求 时 需要 设 定 的 特定 头 信息 ， 如 {Content-Type:application/json}。 

口 请 求 文件 : 进行 POST、PUT 等 请 求 时 所 需要 发 送 的 文件 内 容 ， 其 格式 为 : 字段 名 : 
文件 路 径 : 文件 MIME 类 型 ， 如 filel:/path/to/xx.jpg:image/ipg。 

口 期望 结果 : 在 响应 内 容 中 需要 检查 的 期 望 值 ， 如 success。 

口 结果 检查 方式 : 以 何 种 形式 对 响应 内 容 进行 检查 ， 如 equal、include 、jsonpath 等 。 

口 响应 编码 : 响应 内 容 的 编码 设置 ， 如 utf-8、gbk 等 。 

测试 数据 的 格式 基本 上 就 是 上 述 这 几 类 数据 字段 组 成 ， 这 些 字段 中 有 些 是 必 选 ， 有 些 是 

; 有 些 是 单 选 ， 有 些 是 多 选 ; 可 以 根据 具体 的 测试 需要 来 增删 相应 的 数据 字段 。 


13.2.2 ”数据 存储 方式 


在 测试 数据 格式 与 内 容 确定 之 后 ， 接 下 来 要 确定 的 就 是 测试 数据 的 存储 方式 。 关 于 测试 
的 存储 ， 通 常 有 文本 和 DB 这 两 种 方式 。 对 于 测试 数据 量 较 少 的 场景 ， 可 以 选择 文本 存 


储 方 
= 


式 ， 其 特点 是 使 用 简单 ， 修 改 方便 ; 对 于 测试 数据 量 较 大 的 场景 ， 可 以 选择 DB 存储 方 
其 特点 是 便于 管理 ， 结 构 化 能 力 强 。 
首先 介绍 下 文本 存储 的 形式 ， 使 用 文本 存储 也 可 以 有 很 多 种 方式 ， 例 如 ，TXT、CSV、 


XML、JSON 等 ， 甚 至 可 以 直接 是 Python 文件 。 考 虑 到 我 们 的 测试 数据 有 部 分 字段 具有 结构 
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化 的 特性 ， 所 以 会 优先 考虑 支持 结构 化 的 存储 方式 ， 例 如 ,XML、JSON 和 了 Python 文件。 这 
里 就 以 JSON 文件 的 形式 来 进行 介绍 ， 其 他 存储 方式 可 以 参考 这 一 形式 。 

13.2.1 节 中 已 经 确定 测试 数据 的 具体 字段 ， 所 以 在 JSON 存储 时 也 需要 把 每 个 字段 都 设 
计 在 其 中 ， 所 以 第 一 版 的 JSON 格式 如 下 面 的 代码 所 示 。 


"url" : "https://github.com/timeline.json", 
"method" : "get", 


"Legw 3 

"expect" : "success", 
"checkType" : "include", 
"encoding" : "utf-8" 


和 


这 里 把 之 前 确定 的 8 个 数据 字段 都 设计 在 其 中 ,并且 都 是 顶级 命名 空间 ; 除了 data、 
headers、files 这 三 个 结构 化 数据 字段 之 外 ， 其 他 都 是 普通 的 文本 字段 。 针 对 这 三 种 结构 化 的 
字段 ， 可 以 通过 表 13-2 进行 了 解 。 


表 13-2 测试 数据 形式 
数据 字段 备注 


配 合 Content-Type=application/x- 
对 "kl=v1&k2=v2" 
9 下 www-form-urlencoded 请 求 头 使 用 


合 Content-Type=application/j 
JSON 串 | "wklw:wvlw wk2wswv2v" yperapplicationfison 


{"Content-Type":"application/json"} 单个 请 求 头 
head -Type":"application/json", " ion": 
eaders JSON 对 象 { Con Whe :"application/json", "Connection": 多 个 请 求 头 
keep-alive"} 
JSON 对 象 | ("fieldName","/path/to/file","image/jpg") 单个 文件 
files [("fieldName","/path/to/file","image/jpg"), a 
("fieldName2","/path/to/file2","image/jpg")] 多 个 文件 
从 图 中 可 以 看 到 ， 这 三 种 数据 类 型 除了 是 结构 化 数据 之 外 ， 还 可 以 支持 多 种 数据 形 


式 ; 之 所 以 这 样 设计 也 是 考虑 到 实际 的 测试 场景 中 会 遇 到 这 些 真 实 的 需求 。 所 以 一 个 完整 的 
JSON 存储 格式 可 以 如 下 所 示 。 


[{ 


"url" : "http://httpbin.org/get", 
"method" : “get", 

"data™" : "kl=vl&k2=v2", 

"headers" : {"Content-Type": 


"application/x-www-form-urlencoded"}, 
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"Hles” 3 I]: 


"expect" : "success", 
"checkType" : "include", 
"encoding" : "utf-8" 


有] 


接 下 来 ， 再 继续 探究 DB 方式 的 存储 形式 ， 同 样 地 ，DB 存储 的 具体 实现 也 有 很 多 种 选 
择 , 例如 ，SQLite3、MySQL、SQL Server， 也 可 以 是 Mongo 这 类 非 关 系 型 数据 库 。 鉴 于 之 
前 已 经 介绍 过 MySQL 方式 的 DB 存储 ， 并 且 这 里 的 测试 数据 具有 结构 化 的 特性 ， 所 以 这 里 
选择 使 用 Mongo 作为 DB 存储 实现 。 


提示 。 MongoDB 是 一 个 介 于 关系 数据 库 和 非 关 系数 据 库 之 间 的 产品 ， 是 非 关系 数据 库 
当中 功能 最 丰富 ， 最 像 关系 数据 库 的 。 它 支持 的 数据 结构 非常 松散 ， 是 类 似 JSON 的 BSON 
格式 ， 因 此 可 以 存储 比较 复杂 的 数据 类 型 。 


由 于 Mongo 天 然 地 支持 JSON 格式 的 数据 ， 因 此 前 面 用 于 文本 存储 的 JSON 格式 可 以 直 
接 用 于 存储 在 Mongo 中 ， 而 无 需 任何 修改 。 当 然 ， 如 果 准 备 使 用 MongoDB 作为 存储 ， 还 需 
要 做 一 些 额 外 的 事情 ， 具 体 的 准备 步骤 如 下 。 

(1 ) 下 载 和 安装 MongoDB 服务 。 

(2 ) 安装 Python 访问 Mongo 的 驱动 程序 。 

(3 ) 为 测试 数据 存储 新 建 一 个 数据 库 。 

(4) 把 JSON 格式 的 测试 数据 保存 到 新 建 的 数据 库 中 。 

确定 好 了 存储 方式 并 保存 好 测试 数据 之 后 ， 剩 下 的 工作 就 是 如 何 去 读 取 测 试 数据 并 一 步 
步 地 执行 API 测试 。 


13.2.3 ”实现 数据 读 取 


首先 要 介绍 的 是 JSON 文本 形式 存储 的 测试 数据 ， 读 取 这 类 形式 的 测试 数据 很 方便 ， 直 
接 先 读 取 文本 的 全 部 内 容 ， 再 对 其 进行 反 序列 化 操作 即 可 。 具 体 的 代码 片段 如 下 。 


def read config (fp, encoding="utf-8"): 
with codecs.open(fp, "rb", encoding) as f: 
txt = f.read() 
return json.loads (txt) 


通过 read_config 方法 就 可 以 读 取 到 指定 文件 路 径 的 JSON 测试 数据 ， 之 后 再 遍历 JSON 
测试 数据 列表 ， 获 取 每 一 条 测试 数据 并 执行 对 应 的 测试 请 求 操作 。 测 试 数据 遍历 与 测试 执行 
的 代码 见 如 下 代码 。 


def run(args) : 
code，txt = demo (args['url']，args['method']， 
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args['data'], args['headers'], 
args['files'], args['encoding']) 
if not args['quite']: 
print code 
print txt 
verify result (code, txt, args['expect']) 


if os.path.exists (config file): 
test data = read config (config file) 
for data in test data: 
run(data) 

else: 
print 'CONFIG File Not Exist' 
exit (1) 


297 


上 述 代 码 中 把 调用 接口 和 检查 结果 的 代码 提取 到 run 方法 中 ， 之 后 对 配置 文件 进行 读 


取 、 遍 历 和 run 方法 调用 ， 这样 就 组 成 了 一 个 完整 的 测试 数据 读 取 和 执行 的 流程 。 


此 外 ， 为 了 能 够 灵活 读 取 不 同 的 JSON 测试 数据 文件 ， 可 以 设计 从 命令 行 参数 来 获取 具 
体 测试 数据 文件 的 路 径 。 为 此 增加 一 个 命令 行 参数 -C 来 接收 测试 数据 文件 的 路 径 , 使 用 -C 


参数 执行 上 述 代码 配置 文件 的 测试 效果 如 图 13-10 所 示 。 


图 13-10 JSON 数据 读 取 


接 下 来 介绍 读 取 MongoDB 中 的 测试 数据 。 首 先 安装 好 Mongo 服务 并 保存 好 测试 数据 ， 


然后 确保 安装 Mongo 的 Python 库 。 可 以 使 用 下 面 的 命令 来 安装 。 


pip install mongo 


现在 就 可 以 使 用 Python 来 读 取 MongoDB 中 的 测试 数据 了 ， 具 体操 作 Mongo 的 代码 如 下 。 


def read mongo (host="127.0.0.1", port=27017, 
db _name='apiman', collection='testdata'): 
client = MongoClient (host, port) 
db = client[db name] 
coll = db[collection] 
return coll.find({}) ### 获取 所 有 记录 
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这 里 为 Mongo 操作 定义 了 一 个 read_mongo 的 方法 ， 它 可 以 接收 指定 的 Mongo 参数 ， 
并 通过 这 些 参 数 来 获取 并 返回 具体 的 表 数 据 。 这 里 默认 数据 库 名 为 apiman， 数 据 集合 为 
testdata， 如 果 定 义 了 其 他 的 名 称 ， 要 记得 在 调用 的 时 候 传递 正确 的 参数 。 

获取 到 MongoDB 中 的 数据 ， 之 后 的 遍历 与 执行 流程 与 文本 方式 基本 一 致 ， 简 要 代码 如 
下 所 示 。 


if db str.strip() == '*': 
test_data = read mongo() 
else: 
db info = db_str.split(':') 
try: 
test data = read mongo(*db info) 
except: 
print 'DB Connect Failure' 
exit (2) 
for data in test_ data: 
data['quite'] = args['quite'] 
run (data) 


同样 地 ， 为 了 能 够 灵活 地 读 取 不 同 数据 库 地 址 ， 所 以 为 Mongo 数据 库 的 连接 信息 也 添 
加 了 命令 行 接收 参数 -D， 使 用 -D 参数 执行 的 效果 如 图 13-11 所 示 。 


ev 


图 13-11 DB 数据 读 取 
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13.3 ”测试 数据 用 例 化 


现在 测试 工具 已 经 可 以 支持 批量 读 取 测试 数据 ， 批 量 执行 测试 的 功能 。 可 以 提前 把 测试 
数据 设计 好 ， 并 保存 到 对 应 的 存储 中 ， 最 后 执行 相应 的 命令 行 参数 即 可 开始 API 自动 化 测试 。 
正如 上 面 所 说 ， 现 在 已 经 可 以 满足 单一 场景 的 批量 执行 操作 ， 但 在 实际 的 项 目 实施 过 程 
中 ， 可 能 不 需要 每 一 次 都 完整 地 执行 一 遍 所 有 的 测试 用 例 ， 例 如 ， 只 针对 某 一 个 API 进行 了 
Bug 修复 时 ， 可 能 只 需 单独 执行 一 次 该 API 相关 的 自动 化 用 例 即 可 。 

此 外 有 些 时候 可 能 只 想 执行 某 个 用 例 ， 并 且 如 果 测 试 执行 失败 ， 也 需要 知道 是 哪 条 用 例 
执行 失败 。 针 对 这 些 实际 项 目 中 会 发 生 的 场景 ， 目 前 的 测试 工具 是 无 法 支持 的 ， 原 因 是 我 们 
的 测试 数据 只 包含 发 送 HTTP 请 求 所 需要 的 元 数据 ， 而 没有 与 测试 用 例 相 关 的 信息 数据 。 

为 了 让 接口 测试 数据 能 够 更 好 地 支持 规划 和 管理 ， 需 要 像 管理 手工 测试 用 例 一 样 ， 给 接 
口 测试 数据 添加 一 些 额 外 的 用 例 信 息 ， 这 就 是 测试 数据 用 例 化 的 过 程 。 


13.3.1 用例 基 本 信息 


通常 一 个 普通 的 测试 用 例 都 会 包含 一 些 基本 的 信息 ， 例 如 用 例 名 、 优 先 级 、 创 建 者 、 备 
注 等 。 为 了 让 接口 自动 化 用 例 便 于 辨识 ， 也 可 以 添加 上 这 些 基 本 信息 ， 具 体 的 实现 方法 就 是 
在 每 一 条 测试 数据 中 添加 对 应 的 字段 即 可 。 增 加 名 称 、 备 注 和 优先 级 之 后 的 接口 测试 用 例 数 
据 形式 如 下 所 示 。 


下 


"name" : "demo Testing", 

"comment" 

PPLOr 二 

we 学 EBY //httpbin.org/get", 

"method" : "get" 

Sdatar 4 okl=vl&k2=v2wy 

"headers"” : 
{"Content-Type":"application/x-www-form-urlencoded"}, 

"fles" : [], 

"expect" : "success", 

"checkType" : "include", 

"encoding" : "utf-8" 


1] 

有 了 这 些 用 例 基本 信息 之 后 ， 就 可 以 很 方便 地 辨识 每 一 个 测试 用 例 的 功能 ， 以 及 可 以 很 
方便 地 查询 出 某 一 条 测试 用 例 ， 或 者 某 一 优先 级 的 测试 用 例 。 

增加 了 用 例 信息 之 后 ， 主 要 在 用 例 查 询 和 筛选 的 时 候 使 用 这 些 信息 ， 为 此 我 们 专门 给 用 
例 名 、 优 先 级 添加 了 两 个 命令 行 参数 -N 和 -P， 通 过 这 两 个 参数 的 内 容 来 过 滤 出 需要 执行 的 
测试 用 例 。 针 对 名 称 和 优先 级 过 滤 的 代码 片段 如 下 所 示 。 

def read_mongo (host="127.0.0.1"，Pport=27017， 


db name='apiman', collection='testdata', condition={}): 
client = MongoClient (host, port) 
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db = client[db_name] 
coll = db[collection] 
return coll.find (condition) ## 获取 记录 


db info = db str.split(':') 
condition = {} 
if test_ name: 
partten = re.compile(test name, re.I) 
condition['name'] = parttern 
if test priority: 
if not test priority.isdigit(): 
print 'Priority Must Be a Num' 
exit (3) 
condition['priority'] = int(test priority) 
if condition: 
db _info.append (condition) 


trys 
test data = read mongo(*db info) 
except: 
print 'DB Connect Failure' 
exit (2) 
述 代 码 中 ， 首 先 对 read_mongo 方法 进行 修改 ， 添 加 condition 参数 并 在 查询 数据 的 


该 参数 进行 过 滤 ; 其 次 对 命令 行 传递 过 来 的 test_name、test_priority 进行 检查 ， 如 


果 使 用 了 对 应 的 参数 则 会 把 参数 内 容 添加 到 查询 条 件 中 ; 最 后 传递 给 read_mongo 方法 。 
提示 “由 于 需要 使 用 到 查询 功能 ， 所 以 上 述 代码 只 适用 于 使 用 MongoDB 的 存储 方式 ， 


且 后 期 与 


查询 功能 相关 的 代码 均 只 支持 DB 存储 方式 。 


例 名 参数 -N 支持 模糊 匹配 ， 而 优先 级 参数 -P 只 接收 整 型 数字 ; 使 用 -N、-P 参 
数 的 执行 效果 如 图 13-12 所 示 。 


针对 


国 CWndoweystem3Nemd [Elm | 


| 


13-12 ”执行 测试 用 例 
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13.3.2 ”用 例 套件 信息 


除了 测试 用 例 自 身 的 一 些 基本 信息 之 外 ， 还 可 以 拥有 一 些 扩展 信息 ; 这 些 扩展 信息 主要 
用 来 关联 用 例 之 间 的 关系 ， 例 如 ， 相 同 模块 的 用 例 、 同 一 阶段 的 用 例 、 同 一 版 本 的 用 例 等 ; 
这 些 都 统一 叫 作用 例 套件 信息 ， 分 别 用 分 类 、 标 签 、 版 本 号 来 表示 。 

用 例 套 件 信息 的 作用 在 于 ， 帮 助 管理 不 同 使 用 场景 的 用 例 集合 ; 单个 模块 的 用 例 可 以 规 
划 在 同一 个 分 类 套件 之 中 ; 不 同 测试 阶段 的 用 例 也 可 以 划分 在 不 同 的 标签 套件 中 ， 例 如 ， 冒 
烟 测试 用 例 集 、 集 成 测试 用 例 集 、 回 归 测 试用 例 集 。 此 外 ， 针 对 具有 多 版 本 的 被 测 系 统 ， 还 
需要 支持 针对 版 本 存储 的 测试 套件 。 

同 测试 用 例 基 本 信息 一 样 ， 添 加 套件 信息 的 方式 也 是 直接 在 测试 数据 中 增加 字段 ， 添 加 
了 分 类 、 标 签 和 版 本 号 的 测试 数据 结构 如 以 下 代码 所 示 。 


[{ 


"name" : "demo Testing", 

"comment" : "™", 

pplority Ys Ts 

"category" : "test", 

"tags" : {"smoking" : 1}, 

"version"” : 1, 

"url" : "http://httpbin.org/get", 

"method" "get", 

"data" :; "kl=vl&k2=v2", 

"headers" : 
{"Content-Type":"application/x-www-form-urlencoded"}, 

"files” :; [], 

"expect" : "success", 

"checkType" : "include", 

"encoding" : "utf-8" 


} 


上 述 代码 中 分 别 增加 了 category、tags、version 三 个 字段 。 一 个 用 例 只 能 有 一 个 分 类 ， 
要 么 属于 这 个 模块 ， 要 么 属于 那个 模块 ; 一 个 用 例 可 以 有 多 个 标签 ， 可 以 是 冒 烟 测试 用 例 ， 
也 可 以 是 回归 测试 用 例 ; 一 个 用 例 可 以 有 多 个 版 本 信息 ， 不 同 版 本 的 用 例 各 自 拥 有 独立 的 测 
试 数据 ， 即 版 本 1 与 版 本 2 是 两 条 测试 数据 。 

在 增加 了 字段 之 后 ， 我 们 的 代码 也 需要 进行 相应 的 修改 来 支持 增加 的 字段 ;与 基本 信息 
一 样 ， 需 要 接收 参数 并 转换 为 过 滤 条 件 来 获取 指定 测试 套件 中 的 用 例 集合 。 具 体 的 实现 代码 
片段 如 下 。 


if category: 
condition['category'] = category 
if tag: 
condition['tags'] = {"$elemMatch":{tag : 1}} 
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if version: 

condition['version'] = version 
if condition: 

db info.append (condition) 
try: 

test_ data = read mongo(*db info) 


在 命令 行 参 数 方面 相应 地 增加 了 -c、-t、-v 参数 来 分 别 接收 category、tag、version 参数 。 
新 参数 的 命令 行使 用 效果 如 图 13-13 所 示 。 
i Zemd.exe (= Sm 


图 13-13 ”测试 套件 执行 


提示 这 里 的 用 例 套件 信息 都 是 基于 项 目 内 的 用 例 管理 ， 如 果 需 要 使 用 该 工具 同时 测试 
多 个 项 目 ， 则 可 以 增加 一 个 project 字段 来 区 分 不 同 的 项 目 用 例 。 


13.3.3 ”用 例 模板 信息 

如 果 只 看 代码 中 的 一 条 用 例 数据 ， 不 会 发 现 有 问题 。 而 当 用 例 数 据 有 很 多 条 的 时 候 ， 可 
能 就 会 发 现 这 些 用 例 数据 中 有 大 量 的 重复 信息 。 例 如 ， 同 一 个 模块 用 例 的 URL、method、 
header、encoding 等 信息 。 为 了 规避 重复 信息 的 存在 ， 需 要 把 可 能 重复 的 信息 都 提取 出 来 ， 
存放 到 一 个 单独 的 文件 ， 这 个 文件 就 叫 作用 例 模板 文件 。 

使 用 模板 文件 的 好 处 是 它 不 仅 可 以 存放 公共 的 用 例 信息 ， 而 且 在 需要 修改 公共 信息 的 时 
候 也 会 非常 方便 。 如 果 没有 提取 到 模板 文件 ， 修 改 那些 相同 信息 时 就 需要 把 所 有 用 例 都 修改 
一 遍 ， 如 果 已 经 使 用 了 模板 文件 ， 则 只 需要 修改 一 次 模板 文件 即 可 。 

模板 文件 的 结构 与 我 们 的 正常 测试 数据 结构 保持 一 致 ， 这 样 才能 作为 基础 模板 。 另 外 ， 
模板 文件 中 只 保存 那些 功能 的 用 例 信息 ， 如 前 面 提 到 的 url、method 、encoding 等 ;当然 还 可 
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以 创建 多 个 模板 ， 不 同 模块 使 用 不 同 的 模板 文件 。 
为 了 让 模板 文件 与 测试 数据 分 离 ， 需 要 把 模板 文件 的 数据 存放 在 单独 的 JSON 文件 或 者 
DB 表 中 。 模 板 文件 的 数据 结构 可 以 是 如 下 所 示 。 
{ 
"templatel": { 
"url": "http://httpbin.org/get", 
"method": "get", 
"headers": { 
"Content-Type": "application/x-www-form-urlencoded" 
}, 
"encoding": "utf-8" 
} 
} 


上 述 代码 中 定义 了 一 个 名 为 templatel 的 模板 ,该 模板 只 定义 了 部 分 必要 的 用 例 信息 ， 
这 些 信息 在 同一 个 功能 模块 中 很 可 能 被 重复 使 用 到 ;而 那些 没有 定义 的 信息 在 不 同 的 用 例 中 
通常 都 会 有 不 同 的 值 。 

有 了 模板 文件 还 要 使 用 到 这 个 文件 ， 它 是 在 测试 数据 读 取 的 时 候 被 用 到 。 具 体 的 使 用 流 
程 如 下 。 

(1) 在 具体 的 测试 用 例 数 据 中 找到 模板 信息 ， 为 此 给 测试 用 例 数据 添加 一 个 template 字 
段 ， 其 值 就 是 具体 的 模板 名 称 。 

(2 ) 根据 模板 名 称 来 获取 到 模板 的 具体 内 容 。 

(3 ) 合并 模板 数据 与 具体 测试 用 例 数据 ， 并 使 用 合并 后 的 数据 来 执行 接口 测试 。 

关于 模板 数据 读 取 的 方法 有 两 个 : 一 个 是 如 代码 清单 13-1 中 读 取 JSON 文件 模板 的 方 
法 ， 另 一 个 是 如 代码 清单 13-2 中 读 取 DB 模板 的 方法 。 


代码 清单 13-1 JSON 文件 模板 


def get_json_template (name) : 
templates = read_config (name) 
if name in templates: 
return templates [name] 


代码 清单 13-2 ”数据 库 模 板 


def get db template (name) : 
templates = read mongo(collection='template', 
condition={'name' : name}) 
if templates and len(templates) > 0: 
return templates[0] 


读 取 模板 内 容 之 后 ， 需 要 对 其 与 具体 测试 数据 进行 合并 操作 ， 这 部 分 的 代码 操作 流程 对 
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于 文本 和 DB 存储 形式 都 是 通用 的 。 具 体 的 实现 细节 如 下 。 


def merge_template (data，ttype) : 
temp = data.get('template') 
if temp and temp.strip(): 


if ttype == 'json': 
template = get json template (temp.strip()) 
elif ttype == "db': 


template = get db template (temp.strip()) 
if template: 
template.update (data) 
data = template 
return data 


上 述 代 码 中 定义 了 一 个 merge_template 方法 ， 该 方法 会 检测 测试 数据 中 是 否 有 使 用 模 
板 ， 如 果 使 用 了 就 会 读 取 对 应 的 模板 信息 ， 并 以 模板 信息 作为 基础 进行 测试 数据 合并 ， 最 后 
返回 合并 后 的 测试 数据 。 


提示 代码 中 的 template.update(data) 表示 使 用 data 字典 的 数据 来 覆盖 template 字典 的 
数据 ， 即 template 中 没有 对 应 的 数据 则 增加 ， 有 对 应 的 数据 则 更 新 ; 也 就 是 说 ， 具 体 测试 用 
例 中 的 数据 优先 级 要 高 于 模板 数据 。 


13.4 测试 流程 控制 


通常 情况 下 测试 流程 只 需 发 送 请 求 、 验 证 结果 这 两 个 基本 步骤 即 可 ， 而 在 实际 的 业务 
中 往往 会 比 这 个 流程 稍微 复杂 点 儿 。 例 如 ， 也 许 需 要 在 执行 某 条 测试 用 例 之 前 先 准备 环境 ， 
也 许 需 要 在 执行 测试 用 例 之 后 恢复 环境 ， 甚 至 是 希望 根据 不 同 的 测试 结果 来 执行 不 同 的 后 续 
用 例 。 

针对 上 面 提 到 的 一 些 场景 需求 ， 目 前 的 测试 流程 还 没有 考虑 进来 ; 为 了 能 够 支持 这 些 场 
景 需 求 ， 就 需要 能 够 对 测试 的 流程 进行 一 些 必要 的 控制 。 具 体 而 言 ， 就 是 在 目前 测试 流程 的 
基础 上 ， 对 每 个 环节 的 前 后 都 添加 上 对 应 的 钩子 函数 接口 ， 图 13-14 为 示意 图 。 

图 中 右 侧 部 分 为 目前 的 测试 基本 流程 ， 左 侧 为 需要 在 不 同 的 环节 插入 的 钩子 函数 接口 。 
从 这 些 接口 的 名 字 可 以 看 出 ， 它 们 与 单元 测试 框架 的 setup 、trardown 的 功能 基本 相同 ， 即 在 
测试 前 后 进行 一 些 测试 支持 与 操作 ， 让 整个 测试 流程 能 够 符合 实际 的 测试 场景 的 要 求 。 

这 些 钩 子 函 数 接口 会 在 测试 流程 的 特定 环节 被 相应 地 调用 ， 如 果 需 要 在 某 个 环节 执行 
一 些 测试 支持 或 操作 ， 则 直接 把 操作 函数 注册 到 该 环节 的 钩子 函数 接口 即 可 。 例 如 ， 在 执行 
A 用 例 之 前 需要 先 执行 B 用例 ， 则 可 以 把 调用 B 用 例 的 函数 C 注册 到 A 用 例 的 Pre-Testing 
接口 。 
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启动 测试 
读 取 测 试 数 据 
所 有 测试 之 前 
遍历 测试 数据 


试 数 
单个 测试 之 前 
单 次 请 求 之 前 
单 次 请 求 之 后 

证 结果 


[en | 


单个 测试 之 后 


所 有 测试 之 后 


13-14 ”钩子 函数 设计 流程 
有 了 这 些 钓 子 函 数 接口 ， 则 前 面 提 到 的 业务 问题 都 可 以 得 到 解决 。 在 请 求 发 送 之 前 需要 
准备 的 事情 可 以 注册 到 Pre-request 接口 ， 在 请 求 发 送 之 后 需要 操作 的 事情 可 以 注册 到 Post- 
request 接口 ， 测 试 之 前 的 准备 可 以 注册 到 Pre-testing 接口 ， 测 试 之 后 的 操作 可 以 注册 到 Post- 
testing 接口 。 


13.4.1 ”钩子 函数 接口 设计 

通过 前 面 的 分 析 ， 可 以 使 用 钧 子 函 数 接口 的 方式 来 解决 一 些 测试 问题 。 本 节 主 要 介绍 
如 何 设计 和 定义 这 些 钧 子 函数 的 原型 。 针 对 不 同 环节 的 钧 子 函数 ， 其 函数 原型 可 能 是 不 一 样 
的 ， 接 下 来 一 一 介绍 。 

1. Pre-All-Testing 接口 

这 个 接口 是 在 所 有 测试 用 例 执 行 之 前 被 调用 ， 由 于 在 测试 数据 读 取 之 后 被 调用 ， 所 以 从 
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该 接口 可 以 获取 到 全 部 的 测试 数据 信息 。 另 外 ， 在 该 接口 会 做 一 些 全 局 的 初始 化 操作 ， 可 能 
会 保存 一 些 初始 化 的 结果 ， 所 以 该 接口 需要 一 个 保存 上 下 文 信息 的 对 象 。 该 接口 具体 的 设计 


原型 如 下 。 


def Pre_all_testing_demo (al1l_test_dqata，CcContext) : 


all_test_data: 所 有 的 测试 数据 ， List 
context : 测试 用 例 上 下 文 信息 ， dict 
return: None， 所 有 信息 通过 上 下 文 来 传递 


pass 


2. Pre-Testing 接口 

这 个 接口 是 在 获取 单条 测试 数据 之 后 被 调用 ， 因 此 通过 该 接口 可 以 获取 到 当前 执行 用 例 
的 测试 数据 ， 并 且 可 以 获取 到 当前 测试 的 执行 轮 次 ， 同 样 地 ， 贯 穿 整个 测试 用 例 的 上 下 文 对 
象 也 可 以 获取 到 。 该 接口 的 设计 原型 代码 如 下 。 


def pre testing demo(test data, index, context): 


test_data: 当前 用 例 的 测试 数据 ， dict 
index: 当前 用 例 的 执行 轮 次 ， int 
context : 测试 用 例 上 下 文 信息 ，dict 
return: None， 所 有 信息 通过 上 下 文 来 传递 


pass 


3. Pre-request 接口 
这 个 接口 是 在 发 送 请 求 之 前 被 调用 ， 所 以 它 可 以 获取 到 当 次 用 例 的 请 求 数据 ， 以 及 上 下 


文 对 象 。 原 型 如 下 所 示 。 


def pre_request demo(request data, context): 
5 


request_data: 当前 请 求 的 测试 数据 ， dict 
context : 测试 用 例 上 下 文 信息 ， dict 
return: None， 所 有 信息 通过 上 下 文 来 传递 


pass 


4. Post-request 接口 
这 个 接口 是 在 请 求 完成 之 后 被 调用 ， 所 以 它 可 以 获取 到 请 求 的 响应 状态 和 响应 内 容 。 原 


型 如 以 下 代码 所 示 。 


def post_request_demo (response code, response data, context): 
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response_code: 当前 请 求 的 响应 代码 ， int 
response_data: 当前 请 求 的 响应 数据 ， string 
context: 测试 用 例 上 下 文 信息 ， dict 

return: None， 所 有 信息 通过 上 下 文 来 传递 


pass 


5. Post-testing 接口 
这 个 接口 在 当前 测试 完成 之 后 被 调用 ， 此 时 已 经 知道 当前 用 例 的 执行 结果 ， 因 此 它 可 以 


获取 到 用 例 执行 结果 。 原 型 如 以 下 代码 所 示 。 


def post testing demo(result, test data, context): 
| 


result: 当前 用 例 的 执行 结果 ，boolean 
test_data: 当前 用 例 的 测试 数据 ， dict 
context: 测试 用 例 上 下 文 信息 ， dict 
return: None， 所 有 信息 通过 上 下 文 来 传递 


pass 


6. Post-all-testing 接口 
这 个 接口 在 所 有 用 例 执行 结束 之 后 才 被 调用 ， 所 以 它 可 以 知道 所 有 测试 执行 的 统计 结 


果 。 设 计 原 型 如 下 代码 所 示 。 


def post all testing demo(summary, context): 
summary: 所 有 测试 结果 统计 信息 ，dict 
context: 测试 用 例 上 下 文 信息 ，dict 
return: None， 所 有 信息 通过 上 下 文 来 传递 


pass 


13.4.2 ”钩子 函数 接口 调用 


设计 好 钩子 函数 的 接口 原型 之 后 ， 就 可 以 在 原 测试 流程 中 加 入 对 钩子 函数 的 调用 操作 。 


由 于 钩子 函数 在 不 同 的 环节 被 调用 ， 需 要 在 原 代码 的 各 函数 中 进行 相应 修改 ， 所 以 这 里 要 分 


必 


来 进行 介绍 ， 这 里 假定 钩子 函数 存放 在 hook 模块 中 。 


1. Pre-all-testing 调用 
该 接口 在 获取 所 有 测试 数据 之 后 调用 ， 所 以 它 的 具体 调用 位 置 为 遍历 测试 数据 之 前 。 在 


我 们 的 测试 工具 中 有 两 处 测试 数据 遍历 的 地 方 ， 分 别 为 JSON 测试 数据 和 db 测试 数据 。 所 以 
该 接口 的 调用 代码 片段 如 下 。 
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from hook import * 

CONTEXT = {} 

test_ data = read config (config file) 


[fun(test data, CONTEXT) for fun in PRE ALL TESTING LIST] 
for data in test data: 


test data = read mongo(*db info) 


[fun(test_ data, CONTEXT) for fun in PRE ALL TESTING LIST] 
for data in test data: 


代码 中 [fun(test_data, CONTEXT) for fun in PRE_ALL _TESTING_LIST] 为 调用 钩子 函数 


的 具体 代码 ，PRE_ALL _TESTING _LIST 为 hook 模块 中 导入 进来 的 函数 列表 ， 该 列表 中 存放 
着 所 有 的 Pre_all_testing 钩子 函数 。 


2. Pre-testing 调用 
该 接口 在 测试 数据 遍历 之 后 调用 ， 所 以 它 的 调用 处 就 在 测试 数据 遍历 代码 之 后 ， 具 体 见 


如 下 代码 。 


test_data = read config (config file) 


index = 0 
for data in test data: 
index += 1 
[fun(data, index, CONTEXT) for fun in PRE_TESTING_LIST] 


test _ data = read mongo(*db info) 
index = 0 
for data in test data: 


index += 1 
[fun(data, index, CONTEXT) for fun in PRE TESTING LIST] 


3. Pre-request 接口 
该 接口 在 请 求 发 送 之 前 调用 ， 所 以 其 代码 调用 之 处 在 HTTP 请 求 函数 内 ， 具 体 见 如 下 


代码 。 


def run(args) : 
Print u' 开始 执行 测试 用 例 : %$s' % args['name'] 
request data = [args['url']，args['method']， 
args['data'], args['headers'], 
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args['files'], args['encoding']] 
[fun (request data, CONTEXT) for fun in PRE REQUEST LIST] 
Code, txt = demo(*request data) 


4. Post-request 接口 
该 接口 在 请 求 发 送 完成 之 后 调用 ， 其 代码 调用 处 同样 在 run 方法 中 ， 具体 见 如 下 代码 。 


def run(args) : 


code，txt = demo (*request_data) 
[fun (code，txt， CONTEXT) for fun in POST REQUEST LIST] 


5. Post-testing 接口 
该 接口 在 验证 结果 之 后 调用 ， 所 以 其 代码 调用 之 处 同样 在 run 方法 内 ， 具 体 见 如 下 
代码 。 


def run(args) : 


flag = Verify_result (code, txt, args['expect']) 
[fun (flag, test_ data, CONTEXT) for fun in POST_ TESTING LIST] 
print u' 测试 用 例 执行 结束 : %s' % args['name'] 


6. Post-all-testing 接口 
该 接口 在 所 有 测试 用 例 都 执行 结束 之 后 调用 ， 其 代码 调用 之 处 在 主 方法 内 ， 具 体 见 如 下 
代码 。 


def main() : 


summary = { 
"count' : COUNT, 
"pass' : PASS， 
Eall® : EAILS 
'skip' : SKIP 
} 
[fun (summary, CONTEXT) for fun in POST ALL TESTING LIST] 


13.4.3 ”钩子 函数 接口 实现 
前 面 已 经 完成 钩子 函数 接口 的 设计 与 调用 。 这 里 以 调用 子 用 例 为 例 ， 介 绍 下 如 何 实现 自 
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己 的 钩子 函数 。 其 完成 的 场景 需求 为 在 父 用 例 执行 之 前 先 执行 子 用 例 ， 执 行 成 功 后 才 执 行 父 
用 例 。 

按照 前 面 的 设计 ， 这 个 需求 需要 实现 Pre-testing 接口 。 该 接口 中 可 以 获取 当前 执行 用 例 
的 所 有 信息 ， 包 括 需要 调用 的 子 用 例 信 息 。 通 过 获取 到 的 子 用 例 信 息 就 可 以 直接 执行 子 用 例 
流程 。 具 体 代码 实现 如 下 。 


def pre_case (test_data，index，context) : 
if not context['continue']: 
return 
if 'pre case' in test data: 
Case name = test data['pre case'] 
pre test data = context['utils'].\ 
get test data by case name (case name) 
if pre test data: 
r= context['utils'].\ 
run with datal(pre test data, index) 
context['continue'] = r 
PRE_TESTING_LIST.append (pre_case) 


代码 中 新 定义 了 一 个 函数 pre_case， 它 接收 了 当前 用 例 的 测试 数据 、 执 行 轮 次 、 测 试 上 
下 文 环境 。 函 数 体 内 会 判断 当前 用 例 是 否 有 子 用 例 ， 如 果 有 子 用 例 则 会 取出 子 用 例 的 测试 数 
据 ， 然 后 使 用 子 用 例 测试 数据 来 执行 一 次 用 例 测试 ， 并 获取 子 用 例 的 执行 结果 ; 最 后 会 把 
pre_case 函数 注册 到 PRE_TESTING_LIST 列表 中 ,保证 该 函数 会 被 正常 调用 。 

需要 注意 的 是 ，context 上 下 文 的 内 容 是 需要 提前 设置 好 ， 针 对 上 述 代 码 的 内 容 ， 其 
context 在 主 模 块 中 应 设置 的 上 下 文 内 容 如 下 所 示 。 


class utils (object): 
def _ init__ (self): 
pass 


CONTEXT = {"continue" : True, "utils" : utils()} 


def run with datal(data, index, ttype='db'): 
[fun(data, index, CONTEXT) for fun in PRE TESTING LIST] 
if not CONTEXT['continue']: 
return 
data = merge template (data, ttype) 
return runl(data) 
CONTEXT['utils'] .run with data = run with data 


def get test data by case name (name): 
condition = {"name" : name} 
test data = read mongo(condition=condition) 
return test data[0] if test data else None 
CONTEXT['utils'] .get_ test data by case name=\ 
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get_test_data_by_case_name 


提示 “由 于 文章 篇 幅 有 限 ， 这 里 CONTEXT 上 下 文 对 象 只 添加 了 针对 性 的 内 容 ; 而 实际 
工具 开发 中 会 把 相关 可 能 用 到 的 上 下 文 内 容 都 添加 到 CONTEXT 对 象 中 。 另 外 ,钩子 函数 的 
实现 也 只 是 针对 单一 特定 场景 ， 如 果 希 望 支持 得 更 通用 点 儿 则 需要 进行 相应 驾 辑 更 改 。 


13.$S ”测试 结果 验证 


测试 结果 的 验证 对 于 整个 测试 过 程 中 来 讲 是 非常 重要 的 ， 如 果 只 执行 不 验证 或 者 验证 结 
果 有 误 都 会 导致 执行 没有 意义 ; 虽然 前 面 已 经 实现 过 简单 的 结果 验证 方法 ， 但 为 了 能 更 好 、 
更 准确 地 体现 测试 结果 ， 对 于 测试 结果 的 验证 还 可 以 添加 一 些 多 样 化 验证 方法 ， 来 针对 性 地 
检查 不 同类 型 的 响应 内 容 。 

本 节 主 要 介绍 常规 响应 内 容 的 一 些 验证 方法 ， 例 如 ， 完 全 等 于 、 内 容 包含 、 正 则 匹配 、 
JSON 查找 等 。 针 对 不 同 的 响应 内 容 和 验证 要 求 ， 可 以 选择 不 同 的 验证 方法 进行 验证 。 例 如 ， 
少量 的 固定 内 容 可 以 使 用 完全 匹配 ， 大 量 的 针对 性 检查 可 以 使 用 内 容 包含 或 者 正则 ，JSON 
格式 的 内 容 则 可 以 使 用 JSONPath 来 检查 。 


13.5.1 ”完全 匹配 

完全 匹配 的 验证 方式 是 最 简单 的 一 种 测试 结果 验证 方式 ， 它 主要 检查 测试 执行 的 响应 内 
容 与 期 望 结果 是 否 完全 一 致 ， 如 果 一 致 则 为 通过 ， 和 否则 为 不 通过 。 这 种 验证 方式 一 般 用 于 检 
查 固定 响应 内 容 的 测试 用 例 。 

由 于 结果 验证 是 一 个 相对 独立 的 功能 ， 且 为 了 便于 后 期 增加 其 他 验证 方式 ， 我 们 把 对 结 
结果 验证 的 功能 都 提取 到 独立 的 模块 ， 这 里 的 模块 名 为 Validatorpy。 只 包含 一 个 完全 匹配 验 
证 方式 的 结果 验证 模块 的 内 容 如 下 所 示 。 


#!/usr/bin/env Python 
= Odiny UtE-B =*s 


class Validator (object): 
Q@staticmethod 
def get method mapping(): 
return { 
"equal" : Validator. equal 
站 


@staticmethod 
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def verify(content, expect, vtype): 
Content = Content.strip() 
expect = expect.strip() 
func = Validator. get method mapping() .get (vtype) 
if func and callable (func) : 
return func (content， expect) 


@staticmethod 
def _equal (content， expect) : 
return True if content == expect else False 


代码 中 新 建 了 一 个 名 为 Validator 的 类 ， 该 类 实现 了 几 个 staticmethod， 主 方法 verify 是 


对 外 提 人 


t 服 务 的 接口 ， 通 过 该 方法 就 可 以 调用 到 对 应 的 验证 方法 。verify 方法 接收 三 个 参数 ， 


分 别 是 响应 内 容 、 期 望 结果 、 检 查 方式 ， 其 中 ， 检 查 方式 是 用 来 适 配 不 同 的 验证 方法 的 。 


提示 ”这 里 使 用 了 staticmethod 静态 方法 ， 是 因为 我 们 的 调用 场景 不 需要 初始 化 较 多 的 
数据 ， 各 方法 之 间 功 能 比较 独立 ， 而 且 每 次 循环 时 只 调用 一 次 ， 使 用 静态 方法 可 减少 一 次 对 
象 实例 化 过 程 。 


13.5.2 


内 容 包 含 


内 容 包含 的 验证 方式 是 验证 响应 内 容 中 是 否 包含 期 望 结果 的 内 容 ， 即 在 响应 内 容 中 进行 


子 字符 
证 方式 上 


的 查询 。 如 果 期 望 结 果 是 响应 内 容 的 子 串 ， 则 验证 为 通过 ， 否 则 为 不 通过 。 这 种 验 
较 适 用 于 响应 内 容 部 分 固定 的 测试 用 例 ， 且 我 们 的 检查 点 属于 其 固定 部 分 。 


内 容 包含 的 功能 实现 非常 简单 ， 基 于 前 述 代码 基础 ， 针 对 内 容 包含 新 增 的 代码 内 容 


如 下 。 


cla 


这 


ss Validator (object): 


@staticmethod 
def get method mapping(): 
return { 
"equal" : Validator. equal, 
"include" : Validator. include 
} 
@staticmethod 


def _include (content， expect): 


return True if expect in content else False 


有 又 新 增 了 一 个 _include 静态 方法 ， 其 作用 就 是 检查 是 否 有 子 串 包括 。 另 外 ， 还 要 在 


适 配 映 射 表 中 注册 下 新 增 的 _include 方法 。 
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13.5.3 ”正则 匹配 

正则 匹配 的 验证 方式 主要 检查 响应 内 容 能 否 匹 配 期 望 结果 中 的 正则 表达 式 。 如 果 能 匹配 
验证 通过 ， 否 则 为 不 通过 。 这 种 验证 方式 可 以 用 来 检查 响应 内 容 不 固定 ,但 有 一 定 逻 辑 规律 
可 循 的 测试 用 例 。 

正则 匹配 功能 的 实现 也 比较 简单 ， 但 需要 注意 下 正则 匹配 时 使 用 的 标识 。 例 如 ， 是 否 为 
大 小 写 敏 感 ， 是 否 支持 跨行 匹配 等 。 具 体 新 增 的 代码 实现 如 下 所 示 。 


#!/usr/bin/env Python 
= odings tL = 
import re 


class Validator (object): 


@staticmethod 
def get method mapping() : 
return { 
"equal" : Validator. equal, 
"include" : Validator._include， 
"regex" : Validator. regex 
} 
@staticmethod 


def regex(content, expect): 
r= re.Search (expect， content, re.DOTALL) 
return True if r else False 


这 次 添加 了 一 个 _regex 静态 方法 ,专门 用 来 检查 正则 匹配 是 否 通过 。 这 里 的 匹配 标识 只 
使 用 了 re.DOTALL， 表 示 正 则 的 . 符号 可 以 支持 跨行 的 内 容 匹配 。 另 外 ， 因 为 没有 加 re.I 标 
识 ， 所 以 正则 匹配 时 是 大 小 写 敏感 的 。 


13.5.4 JSONPath 


JSONPath 的 验证 方式 主要 用 于 验证 JSON 格式 的 响应 内 容 ， 关 于 JSONPath 的 安装 在 
12.4 节 已 经 介绍 过 ， 这 里 主要 介绍 如 何 把 JSONPath 的 验证 功能 添加 到 API 工 具 中 。 针 对 
JSONPath 验证 方式 的 新 增 代码 如 下 。 


#!/usr/bin/env python 

和 MESA 
import json 

from jsonpath import jsonpath 


class Validator (object): 
@staticmethod 
def get method mapping() : 
return { 
"equal" : Validator. equal, 
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"include" : Validator. include, 
"regex" : Validator. regex, 
"json" : Validator. json 
} 
@staticmethod 
def _json (content， expect): 
if '|' in expect: 
jpath, value = expect.split('|', 1) 


else: 
jpath, value = expect, None 


try: 

nodes = jsonpath (json.loads (content), jpath) 
except: 

print " 响应 内 容 不 是 JSON 格式 " 


return False 


if nodes: 
if value and nodes[0] != value: 
return False 
else: 
return False 
return True 


代码 中 新 增 了 一 个 _json 方 法 进行 JSONPath 的 验证 ， 它 先 对 传 进来 的 期 望 结果 进行 
处 理 ， 得 到 需要 检查 的 JSONPath 实际 路 径 以 及 该 路 径 节点 所 对 应 的 值 。 当 期 望 结 果 只 有 
JSONPath 路 径 而 没有 节点 值 的 时 候 表示 只 检查 节点 存在 即 可 ， 无 须 检 查 节点 内 容 ; 而 期 望 结 
果 同 时 含有 JSONPath 和 节点 值 时 ， 既 要 检查 节点 存在 也 要 检查 节点 内 容 。 

假设 某 条 测试 用 例 的 响应 内 容 为 {"success" : "true"}， 则 只 检查 节点 的 调用 方法 示例 
如 下 。 


Validator.verify('{f"success" : "true"}', "$.success", "json") 
同时 检查 节点 与 节点 值 的 调用 方法 示例 如 下 。 
Validator.verify('{"success" : "true"}', "$.success|true", "json") 


至 此 ， 针 对 API 测试 工具 设计 的 结果 验证 器 已 经 完成 设 定 的 功能 ， 接 下 来 就 要 把 原来 的 
结果 验证 方法 替换 为 新 的 结果 验证 器 方法 。 共 有 一 处 修改 在 verify_result 方法 中 ， 修 改 前 后 
的 代码 片段 如 下 。 


## 原 代码 检查 结果 逻辑 
if expect not in txt: 
Print u' 测试 失败 : 响应 内 容 期 望 包含 $s ， 实 际 未 包含 ' % expect 


return False 


## 替换 为 新 的 结果 验证 器 方法 


if Validator.verify(txt, expect, ttype): 
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print u' 测试 通过 " 

return True 
else: 

return False 


提示 代码 中 替换 为 新 的 结果 验证 器 之 后 ， 没 有 打印 测试 失败 的 日 志 。 主 要 是 因为 这 里 
的 失败 类 型 不 止 一 种 ， 为 了 能 更 准确 地 打印 失败 信息 ， 测 试 日 志 需 要 在 验证 器 方法 内 部 进行 
打印 ; 13.6 节 会 进行 相关 介绍 。 


13.6 测试 数据 记录 


对 于 常规 测试 而 言 ， 每 次 执行 之 后 都 需要 有 测试 文档 输出 ， 这 里 的 测试 输出 文档 通常 指 
的 是 测试 结果 ， 此 外 还 可 以 包括 测试 日 志 。 测 试 结果 一 般 会 以 表格 的 形式 统计 汇总 出 来 ， 并 
发 送 给 项 目 相关 人 员 ， 而 测试 日 志 主 要 用 来 辅助 调试 、 维 护 失败 的 测试 用 例 。 

在 前 面 的 功能 实现 中 ， 只 对 测试 结果 进行 命令 行 回 显 ， 而 没有 对 测试 的 详细 信息 进行 记 
录 ， 也 没有 在 测试 过 程 中 进行 相关 日 志 的 记录 。 本 节 主 要 介绍 为 测试 工具 添加 结果 记录 和 日 
志 记录 的 相关 功能 。 


13.6.1 结果 记录 

顾名思义 ， 结 果 记 录 主 要 用 来 记录 测试 的 执行 结果 以 及 测试 执行 的 通过 率 等 相关 数据 ， 
通过 测试 结果 数据 可 以 辅助 我 们 确定 当前 系统 的 可 用 性 、 稳 定性 ; 如 果 通 过 率 较 高 则 表示 系 
统 的 各 功能 模块 都 可 以 正常 运行 ， 如 果 失 败 率 较 高 则 可 能 是 由 于 版 本 升级 导致 的 功能 异常 ， 
持续 的 较 高 通过 率 则 表示 系统 在 升级 的 过 程 中 仍 保持 着 功能 稳定 性 。 

通常 结果 记录 中 主要 记录 的 信息 有 : 项 目 名 、 用 例 名 、 用 例 分 类 、 用 例 版 本 、 执 行 结果 、 
执行 时 间 等 。 而 除了 这 些 基 本 的 用 例 信息 之 外 ， 还 需要 一 些 辅助 的 信息 ， 例 如 ， 每 次 批量 测 
试 执行 之 后 ， 在 准备 查看 该 批 次 的 测试 结果 时 ， 就 需要 一 个 统一 的 标识 来 把 这 一 批 次 的 所 有 
测试 结果 归 类 到 一 个 集合 中 ; 否则 在 众多 的 测试 结果 记录 历史 中 ， 就 无 法 追溯 哪些 测试 结果 
是 需要 被 查看 的 。 

为 了 解决 这 个 问题 ， 这 里 会 在 每 次 启动 批量 测试 的 时 候 ， 新 建 一 个 任务 名 来 代表 本 次 测 
试 执行 操作 ; 之 后 在 测试 结果 的 每 一 条 记录 中 会 添加 上 这 个 任务 名 字段 ， 这 样 就 可 以 把 同一 
批 次 执行 的 测试 结果 给 关联 起 来 ;而 这 个 任务 名 的 默认 值 就 是 启动 测试 的 时 间 戳 。 

在 API 测试 工具 中 为 了 记录 测试 结果 信息 ， 需 要 保存 为 两 个 表 : task，testresult。task 表 
用 来 记录 每 次 执行 时 新 建 的 任务 名 ，testresult 表 用 来 记录 具体 的 用 例 执行 结果 。 测 试 结果 记 
录 的 实现 代码 如 下 。 


316 ”了 罗 Python Web 自动 化 测试 设计 与 实现 


def write mongo (host="127.0.0.1", port=27017, 
db_name='apiman', collection='testresult', record={}): 
client = MongoClient (host, port) 
db = client[db name] 
coll = db[collection] 
return coll.insert one (record) ## 添加 记录 


def add task(test data): 
task name = test data.get('task name', int (time.time())), 
test data['task name']=task name 
info = {'name': task name} 
write_ mongo(collection='task', record=info) 


def add result (test data): 
result info = { 


task name" : test data.get('task name'), 
"project name" : test data.get('project name'), 
"testcase name" : test data.get('name'), 
"category" : test data.get('category'), 
"version" : test data.get('version'), 

"result" : test data.get('result'), 

"time" ; int(time.time()) 


} 


write mongo (record=result info) 


代码 中 新 增 了 add_task 和 add_result 方法 。add_ task 方法 用 来 添加 任务 名 ，add_result 方 
法 用 来 添加 测试 执行 结果 ， 它 们 都 接收 一 个 测试 数据 对 象 作为 参数 ， 并 通过 该 参数 获取 到 测 
试 结果 相关 信息 ， 最 后 调用 write_mongo 方法 写 人 到 数据 库 中 。 

add_task 方法 在 测试 执行 之 前 调用 ，add_result 方法 会 在 结果 检查 完 之 后 进行 调用 ， 其 调 
用 的 代码 片段 如 下 。 


def run_with_db (args) : 
add task (args) 


flag = Verify_result (code，txt，args ['expect']，args['checkType']) 
args['result'] = fag ## 添加 执行 结果 信息 

add result (args) ## 调用 添加 结果 方法 

[fun (flag, CONTEXT) for fun in POST TESTING LIST] 


除了 需要 记录 每 条 用 例 的 执行 结果 之 外 ， 在 所 有 用 例 执行 结束 之 后 ， 还 需要 对 测试 结果 
进行 一 个 统计 ， 例 如 ， 用 例 执 行 总 数 、 用 例 执 行 成 功 数 、 用 例 执 行 失败 数 、 用 例 执 行 跳 过 数 
等 。 这 些 都 是 用 例 执 行 的 概要 信息 ， 所 以 也 需要 存储 到 独立 的 summary 表 中 ， 记 录 统 计 信息 
的 流程 与 记录 测试 结果 相似 ， 具 体 实现 代码 如 下 。 


def add summary (task name, Summary) : 
info = {"task name" : task name} 
info.update (summary) 


代码 中 实现 了 一 个 add_summary 方法 ， 方 法 中 先 组 装 summary 表 的 记录 信息 ， 再 调用 
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write mongo(collection="summary", record=info) 


write_mongo 方法 写 人 到 summary 表 中 。 该 方法 需要 在 最 外 层 的 主 方法 中 调用 ， 具 体 调 用 代 
码 片 段 如 下 。 


summary = { 
'count' : COUNT, 
"pass' : PASS, 


} 


‘fail' : FAIL, 
"skip' : SKIP 


add_summary (args['task name'], summary) ## 调用 添加 统计 方法 
[fun (summary, CONTEXT) for fun in POST ALL TESTING LIST] 


13.6.2 日 志 记 录 


日 


志 记录 主要 记录 测试 过 程 中 的 一 些 状 态 信息 ， 在 这 里 把 日 志 信息 分 为 两 类 ， 一 类 是 只 


在 命令 行 回 显 的 日 志 信 息 ， 另 一 类 是 记录 在 DB 中 的 测试 详情 信息 。 


命令 行 回 显 的 信息 记录 着 当前 测试 状态 ， 例 如 ， 测 试 开 始 执行 、 用 例 开 始 执行 、 请 求 


始 发 送 


、 测 试 通过 、 测 试 失败 、 请 求 接收 等 。 而 DB 中 记录 的 日 志 主 要 为 测试 结果 详情 ， 例 


如 ， 请 求 响应 内 容 、 期 望 结 果 等 。 
命令 行 回 显 的 日 志 之 前 已 经 有 过 打印 ， 而 DB 需要 记录 测试 结果 详情 还 没有 实现 ， 这 里 
主要 介绍 DB 日 志 记录 的 实现 。 关 于 DB 日 志 需 要 记录 的 信息 如 下 。 


口 
口 
口 
口 
口 
口 


执行 任务 名 。 
用 例 名 。 
响应 码 。 
响应 内 容 。 
期 望 结果 。 
测试 失败 详情 。 


其 中 ， 执 行 任务 名 、 用 例 名 与 testresult 表 中 的 记录 保持 一 致 ， 目 的 就 是 保证 两 个 表 中 记 


录 的 关联 性 ; 响应 码 和 响应 内 容 是 后 期 复查 失败 原因 时 的 重要 参考 ; 测试 失败 详情 是 对 测试 


失败 原 


因 的 直接 描述 。 


为 了 让 测试 日 志 与 测试 结果 的 记录 相对 独立 ， 这 里 单独 使 用 testlog 表 来 存放 测试 日 志 信 
息 。 测试 日 志 DB 存储 形式 的 实现 代码 如 下 。 


def add log(test_data) : 


test_1og = { 
"task name": test_data.get('task_name')， 
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"project_name": test data.get('project name'), 
"testcase name": test data.get('name'), 
"resp_code": test data.get('resp code'), 
"resp_ text": test data.get('resp text'), 
"expect": test data.get('expect'), 
"checkType": test data.get('checkType'), 
"msg": test data.get ('msg') 

} 

write mongo(collection="testlog", record=test lo0g) 


该 代码 需要 记录 的 信息 中 ， 除 了 resp_code、resp_text、msg 之 外 ， 其 他 信息 在 原 测试 数 
据 中 都 已 经 包含 。 这 三 个 信息 需要 在 测试 执行 过 程 中 动态 地 获取 并 设置 ，resp_code 、resp_ 
text 在 请 求 接收 之 后 设置 ，msg 在 结果 验证 失败 时 设置 。 具 体 设置 与 调用 的 代码 片段 如 下 。 


code, txt = demo(*request data) 
args['resp code'] = code 
args['resp text'] = txt 


flag, msg = verify result(code, txt, args['expect'], 
args['checkType']) 

args['result'] = flag 

args['msg'] = msg 

add_ result (args) 

add log(args) 


注意 ”如果 需要 使 用 测试 数据 记录 功能 ， 请 先 确保 安装 了 MongoDB 服务 ， 并 且 命令 行 
与 JSON 配置 文件 形式 执行 的 用 例 都 是 单 用 例 模 式 。 该 功能 模块 主要 应 用 于 使 用 DB 存储 测 
试 数据 的 形式 。 


到 目前 为 止 ， 关 于 API 工具 的 设计 与 功能 实现 都 已 经 介绍 完毕 。 本 章 先 从 一 个 最 简单 的 
API 请 求 工具 开始 ， 逐 渐 增 加 并 完善 与 API 自动 化 测试 相关 的 功能 模块 ， 最 后 实现 了 一 个 具 
有 完整 API 测试 功能 的 基础 工具 。 

本 章 介绍 的 API 测试 工具 是 一 个 命令 行 工具 ， 在 执行 单个 API 测 试用 例 时 ， 既 可 以 通过 
命令 行 参数 执行 ， 也 可 以 通过 JSON 配置 文件 参数 执行 ; 在 多 个 API 测试 用 例 执行 时 则 需要 
通过 MongoDB 来 存储 测试 数据 和 测试 结果 。 

关于 本 章 中 介绍 到 的 相关 完整 代码 可 以 从 GitHub 来 获取 ， 具体 地 址 为 : https://github. 
com/five3/python-Selenium-book/tree/master/apiman。 另 外 ， 为 了 方便 介绍 相关 功能 的 添加 流 
程 ， 在 代码 整体 的 结构 上 并 没有 做 过 多 的 设计 ， 后 期 会 有 一 个 重 构 版 本 的 发 布 ， 想 要 获取 重 
构 版 本 的 读者 欢迎 加 入 http://www.testqa.cn/ 的 “Python Web 自动 化 测试 设计 与 实现 ”小 组 来 
索取 。 


CHAPTER 


第 14 章 1 
集成 为 Web 服务 


第 13 章 介 绍 了 如 何 自己 实现 一 个 Web API 的 自动 化 测试 工具 ， 并 且 可 以 通过 命令 行 来 
启动 批量 的 自动 化 测试 ， 最 后 把 测试 结果 都 统一 记录 到 DB 中 。 总 的 来 讲 ， 之 前 的 Web API 
测试 工具 已 经 可 以 帮 有 我 们 实现 自动 化 测试 的 工作 ， 但 是 就 易 用 性 和 效率 来 讲 ， 之 前 的 工具 还 
是 有 很 多 需要 改进 和 提升 的 部 分 。 例 如 ， 测 试 执行 只 能 通过 命令 行 方式 ， 没 有 UI 界 面 ; 不 
能 很 方便 地 新 建 执行 用 例 集 ; 所 有 测试 工程 师 机 器 上 都 需要 有 一 套 工具 代码 和 执行 环境 ; 不 
能 很 方便 地 查看 测试 结果 等 。 

为 了 解决 这 些 问 题 ， 可 以 考虑 把 API 工具 制作 成 一 个 Web 工具 ， 一 方面 可 以 提供 所 需 
要 的 UI 界 面 ， 另 一 方面 可 以 提供 统一 的 测试 服务 ， 并 且 只 维护 一 套 测 试 工具 代码 和 测试 用 
例 数据 即 可 。 本 章 开 始 就 介绍 如 何 把 第 13 章 的 API 工具 集成 到 Web 服务 中 。 


14.1 Web 服务 简介 


在 正式 介绍 如 何 集成 Web 服务 之 前 ， 先 来 了 解 下 什么 是 Web 服务 。 简 单 来 讲 ，Web 服 
务 就 是 一 种 通过 HTTP 进行 通信 并 提供 远程 服务 的 技术 。 在 当今 的 社会 中 ，Web 服务 已 经 是 
无 处 不 在 了 ， 最 直接 可 以 感受 到 的 就 是 通过 浏览 器 上 网 ， 或 者 手机 APP 浏览 一 些 信息 ， 它 们 
都 是 基于 Web 服务 的 。 

关于 HTTP 的 工作 流程 在 之 前 的 章节 中 已 经 介绍 过 了 ， 有 需要 的 读者 可 以 返回 之 前 的 章 
节 查 看 。 而 本 章 介绍 的 Web 服务 就 是 在 HTTP 之 上 的 具体 应 用 ， 它 的 工作 原理 和 HTTP 的 工 


令 
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作 流程 完 全 一 致 ， 只 是 本 章 介绍 的 Web 服务 是 专门 为 我 们 的 自动 化 测试 所 定制 的 。 图 14-1 


就 是 API 工具 服务 的 工作 流程 。 
”| API 工 具 服务 一 一 一 一 ”| API 服 务 


图 14-1 API 工具 工作 流程 


为 了 让 API 工具 可 以 集成 到 Web 服务 中 ， 需 要 先 来 学 习 下 如 何 实现 一 个 简单 的 Web 服 
务 ， 而 后 再 介绍 如 何 把 API 工具 集成 到 这 个 Web 服务 中 。 实 现 一 个 简单 的 Web 服务 的 过 程 
可 以 分 为 以 下 三 个 步骤 。 

(1 ) 选择 一 个 Web 框架 。 

(2 ) 实现 一 个 快速 DEMO。 

(3 ) 框架 的 基础 使 用 学 习 。 


14.1.1 ”Web 框架 选择 


在 Python 中 可 以 选择 的 Web 框 架 有 很 多 ， 例 如 ，Django、Torado、Bottle、Flask、 
web.py、web2py 等 。 它 们 当中 有 的 框架 功能 丰富 ， 有 的 框架 结构 灵活 ， 有 的 框架 响应 迅速 ， 
在 不 同 的 场景 下 可 以 有 针对 性 地 选择 它们 其 中 的 一 个 。 这 里 选择 的 则 是 Flask 框架 ， 理 由 是 
它 对 Web 开发 的 基础 接口 都 进行 了 恰到好处 的 封装 ， 既 满足 了 基础 开发 需求 又 不 失 框架 的 灵 
活性 ; 并 且 相 对 于 开发 一 个 测试 工具 来 讲 ，Falsk 的 学 习 成 本 还 是 可 以 接受 的 。 

在 确定 使 用 Flask 框架 之 后 ， 就 可 以 开始 安装 Flask 的 开发 环境 了 。 安 装 Flask 可 以 使 用 
下 面 的 命令 。 

pip install Flask 

安装 结束 之 后 可 以 进入 到 Python 解释 器 环境 ,测试 下 Flask 是 否 安装 成 功 ， 测 试 成 功 后 
的 效果 如 图 14-2 所 示 。 
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= EPE 


- 二 — 
丽 C\Windows\system32\emd.exe - Python 


图 14-2 ”测试 Flask 模块 


14.1.2 DEMO 实现 
Flask 环境 搭建 完成 之 后 ， 就 可 以 来 开发 第 一 个 Web 应 用 了 ， 按 照 惯例 第 一 个 demo 应 
该 是 Hello World， 其 示例 代码 如 下 。 


from flask import Flask 
app = Flask(_ name_) 


Qapp.route('/') 
def hello world(): 

return 'Hello World! 
if _name ==' main _': 


app.run() 
把 上 述 代码 保存 到 一 个 Python 文件 中 ， 这 里 假设 保存 到 apiweb.py 文件 ;然后 就 可 以 在 
命令 行 启动 Web 服务 了 ， 启 动 后 的 效果 如 图 14-3 所 示 。 


o quit) 


图 14-3 启动 Flask 服务 
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从 图 14-3 中 启动 后 回 显 的 信息 来 看 ，Web 服务 已 经 正常 启动 ， 并 且 监 听 的 是 本 地 机 器 
的 5000 端口 ， 所 以 可 以 在 本 机 通过 http://127.0.0.1:5000/ 这 个 URL 来 访问 该 Web 服务 ， 划 
效果 如 图 14-4 所 示 。 


=| [= Sm) 
170015000 Ms 
€ > C O1270015000 女 | 四 上: 


Hello World! 


图 14-4 访问 Flask 页 面 


除了 默认 的 启动 参数 之 外 ， 还 可 以 设 定 自 定义 的 启动 参数 。 例 如 ， 监 听 的 端口 默认 为 
5000， 可 以 根据 需要 设置 为 其 他 端口 。 同 样 ， 默 认 情况 下 只 有 本 机 可 以 访问 该 Web 服务 ， 其 
他 机 器 是 不 可 以 访问 的 ， 如 果 人 允许 其 他 机 器 可 以 访问 则 需要 设置 host 参数 。 关 于 启动 参数 的 
设置 如 下 。 


if _name == ' main _': 
app.run (debug=False, host='0.0.0.0', port=8000) 


通过 上 述 代 码 启动 的 Web 服务 就 可 以 被 外 部 机 器 访问 了 ， 并 且 访 问 的 端口 换 成 了 8000。 
另外 ， 在 启动 了 Web 服务 之 后 如 果 需 要 停止 服务 ， 则 可 以 使 用 Ctrl+C 组 合 键 来 中 断 。 


提示 “在 开发 环境 下 可 以 打开 debug 模式 ， 这 样 在 修改 代码 的 时 候 Flask 会 自动 重 载 新 
的 代码 ， 而 无 须 通过 手动 重启 服务 来 生效 。 另 外 ，debug 模式 下 如 果 出 现 异 常 还 会 提供 一 个 
非常 有 用 的 调试 器 页 面 。 


14.1.3 ”框架 开发 学 习 


纵然 我 们 已 经 知道 如 何 可 以 启动 一 个 Web 服务 ,但 是 作为 开发 一 个 可 用 服务 为 目标 的 前 
提 下 ， 我 们 还 需要 对 Flask 框架 进行 更 多 的 学 习 和 掌握 。 

对 于 Web 框架 的 开发 流程 来 讲 ， 不 论 是 Java 还 是 Python，Django 或 是 Flask， 它 们 最 
终 抽象 出 来 的 主流 程 都 是 相同 的 ， 即 它们 都 是 围绕 URL 映射 、 请 求 处 理 、 返 回 结果 这 三 大 
步 又 来 提供 服务 的 。Web 框架 内 部 的 主流 程 图 如 图 14-5 所 示 。 
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DB 
Model 
请 求 处 理 函数 返回 结果 


图 14-5 ”Web 框架 使 用 流程 


图 中 除了 Web 框架 开发 的 三 大 步骤 之 外 ， 还 有 我 们 经 常 听 到 的 MVC 结构 ， 即 控制 器 、 
视图 、 数 据 模型 分 离 的 框架 结构 。 基 本 上 现在 流行 的 和 最 常用 的 Web 框架 都 是 基于 图 14-5 中 
结构 来 设计 和 开发 的 。 因 此 在 对 任何 Web 框架 进行 人 门 学 习 的 时 候 ， 都 要 先 从 这 4 点 开始 。 


1. URL 映射 

URL 映射 在 Web 框架 中 的 专业 名 词 叫 作 路 由 〈Route)， 它 主要 的 作用 就 是 预先 把 用 户 需 
要 访问 的 URL 路 径 与 该 请 求 的 处 理 函 数 进行 关联 ; 简单 来 讲 就 是 每 一 个 URL 的 请 求 都 是 要 
有 一 个 对 应 的 处 理 函 数 的 ， 而 URL 和 处 理 方法 的 对 应 关系 就 是 通过 路 由 来 维护 的 。 

前 述 代码 中 就 使 用 了 路 由 ， 其 中 与 路 由 相关 的 代码 如 下 。 

Qapp.route('/') 


def hello world(): 
return 'Hello World! ' 


代码 中 @app.route 就 是 路 由 的 装饰 器 ， 它 接收 一 个 URL 参数 来 表示 可 以 被 访问 的 地 址 ， 
而 被 它 所 装饰 的 函数 就 是 该 URL 请 求 的 处 理 函 数 。 上 述 代码 中 所 设 定 的 路 由 映射 关系 如 图 


14-6 所 示 。 
/ hello_world0 


图 14-6 ”URL 映射 关系 
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同样 地 ， 还 可 以 添加 更 多 的 URL 映射 关系 ， 直 到 满 足 所 开发 应 用 的 需求 。 类 似 的 URL 
构造 还 可 以 是 下 面 的 样子 。 

口 @app.route('/hello') 

口 @app.route(Vhello/world) 

DO @app.route('/hello/<username>') 


DO @app.route('/post/<int:post_id>') 

其 中 ,第 1 项 和 第 2 项 与 前 述 代码 中 的 效果 一 样 ， 只 不 过 匹配 URL 路 径 变 长 了 而 已 ; 
第 3、4 项 属于 支持 动态 匹配 的 URL 规则 ， 即 该 URL 规则 匹配 的 URL 路 径 不 是 固定 的 ， 它 
可 以 匹配 符合 规则 的 任意 URL 请 求 。 

动态 URL 匹配 的 规则 是 在 URL 路 径 中 添加 变量 占 位 符 ， 这些 占 位 符 的 表示 方式 为 
<variable_name>， 匹 配 成 功 之 后 这 部 分 的 内 容 将 会 作为 命名 参数 传递 给 处 理 函 数 。 此 外 ， 还 
有 另 一 种 占 位 符 表 示 方 式 为 <converter:variable_name>， 它 会 把 变量 部 分 的 内 容 转 换 为 对 应 
的 类 型 。 

第 3 项 和 第 4 项 的 URL 规则 分 别 实 现 了 两 种 方式 的 动态 URL 匹配 的 方式 ， 第 3 项 不 会 
转换 变量 类 型 ， 第 4 项 会 把 变量 转换 为 int 型 。 如 下 代码 列 出 了 这 些 URL 规则 的 使 用 方法 及 
可 以 匹配 到 的 URL 样 例 。 


可 匹配 如 下 样式 的 URL 
/hello/Lily 
/hello/Lucy 
/hello/Tom 
/hello/Pony 


@app.route('/hello/<username>') 
def show user profile (username): 
print type (username) 
return 'Hello %s' gg username 


可 匹配 如 下 样式 的 URL 
/post/1 
/post/2 
/post/3 
/post/4 


@app.route('/post/<int:post id>') 
def show post (post id): 
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Print type (Post_id) 
return "Post %d' % post id 


提示 <converter:variable name> 方 式 的 占 位 符 中 ,converter 只 有 三 个 值 可 选 : int、 


float、path。 其 中 ，int 表示 只 接受 int 类 型 的 内 容 ，float 只 接受 float 类 型 的 内 容 ， 
接受 带 斜 线 的 内 容 。 


path 可 以 


2. 请 求 处 理 函 数 


所 谓 的 请 求 处 理 函 数 就 是 路 由 中 与 URL 有 映射 关系 的 函数 ， 它 专门 用 来 处 理 对 应 URL 


的 请 求 。 前 述 代 码 中 的 hello_world 和 show_user_profile、show_post 都 是 请 求 处 理 


函数 。 请 


求 处 理 函 数 是 承上启下 的 一 个 关键 点 ， 在 这 个 函数 中 可 以 做 如 下 这 些 事情 。 
(1) 响应 URL 请 求 。 
(2 ) 获取 请 求 的 所 有 信息 ， 包 括 请 求 参 数 、 请 求 头等 。 
〈3 ) 处 理 业 务 逻 辑 。 
(4) 返回 处 理 结果 ,包括 设置 响应 头 。 


在 之 前 的 代码 中 虽然 有 使 用 到 请 求 处 理 函 数 ， 但 都 没有 做 任何 的 业务 逻辑 处 理 就 直接 返 
回 了 结果 ; 而 实际 的 Web 服务 开发 过 程 中 ,会 根据 不 同业 务 需求 来 处 理 对 应 的 业务 逻辑 。 例 
如 ,一 个 Web 服务 的 需求 是 根据 请 求 发 过 来 的 商品 价格 和 商品 数量 来 计算 商品 总 价 ， 那 么 请 


求 处 理 函 数 就 需要 针对 这 个 需求 进行 逻辑 运算 并 返回 结果 。 示 例 代 码 如 下 。 
from flask import request 


Qapp.route('/count') 

def count () : 
Price = request.args.get('product price') 
num = request.args.get ('product num') 
return price * num 


从 代码 中 可 以 看 到 ， 我 们 使 用 request.args.get 方 法 获取 到 了 请 求 参 数 ， 然 后 再 把 计算 结 
果 返 回 给 请 求 端 ; 这 里 默认 只 能 处 理 GET 请 求 ， 而 如 果 我 们 希望 同时 还 能 处 理 POST 请 求 ， 


那么 需要 增加 POST 请 求 相关 的 代码 ， 修 改 后 的 代码 内 容 如 下 。 


Q@app.route('/count', methods=['POST', '‘'GET']) 
def count(): 
if request.method == 'GET': 
price = request.args.get('product price') 
num = request.args.get('product num') 
else: 
Price = request.form.get ('product price') 
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num = request.form.get('product_num') 
return price * num 


在 新 的 代码 中 给 route 装饰 器 添加 了 methods 参数 ， 它 专门 用 来 指定 处 理 函 数 可 以 接受 
哪些 HTTP 请 求 方法 ， 默 认 只 接受 GET 方法 。 另 外 ， 我 们 还 添加 了 对 当前 请 求 方法 的 判断 ， 
并 根据 不 同 的 HTTP 请 求 方法 来 获取 对 应 的 请 求 参 数 ， 这 是 因为 GET 方法 和 POST 方法 的 请 
求 参数 需要 从 不 同 的 对 象 中 来 获取 。GET 方法 的 请 求 参数 对 象 为 request.args, 主要 接受 来 自 
URL 中 的 参数 ， 如 ?key=value ; POST 方法 的 请 求 参数 对 象 为 request.form， 主 要 接受 请 求 体 
中 的 参数 。 

此 外 ， 如 果 你 的 请 求 中 有 文件 同时 被 上 传 了 ， 则 获取 文件 参数 的 方法 又 有 所 不 同 ; 此 时 
需要 从 request.files 对 象 来 获取 文件 参数 ， 具 体 的 示例 代码 如 下 。 


from flask import request 
from werkzeug import secure filename 


@app.route('/upload', methods=['POST']) 

def upload file(): 
f = request.files['file field name'] 
f.save('/var/uploads/' + secure filename (f.filename)) 


3. 数据 库 业务 操作 

数据 库 业 务 操 作 指 的 是 对 数据 库 进 行 增 、 删 、 改 、 查 的 操作 ; 这 部 分 的 操作 并 不 是 始终 
都 需要 的 ， 只 有 在 使 用 数据 库 的 应 用 中 才 需 要 。 数 据 库 业务 操作 是 从 请 求 处 理 函 数 中 提取 出 
来 的 专门 针对 数据 库 操 作 的 业务 逻辑 ， 其 目的 是 让 普通 业务 逻辑 与 数据 库 业 务 逻 辑 相 对 分 离 
和 独立 ， 提 高 代码 的 可 维护 性 和 可 读 性 。 

关于 数据 库 业 务 操作 ， 不 同 的 框架 对 其 支持 的 等 级 是 不 一 样 的 ， 例 如 ，Dijango 直接 内 
置 了 一 个 ORM 来 处 理 数据 库 相 关 操作 ， 而 Flask 则 没有 内 置 特定 的 ORM， 所 以 可 以 使 用 任 
意 的 第 三 方 库 ， 如 针对 MySQL 可 以 使 用 Flask-SQLAlchemy 库 ， 而 针对 Mongo 则 可 以 使 
Flask-PyMongo 库 。 

由 于 API 工具 使 用 的 是 Mongo 作为 存储 DB， 所 以 这 里 介绍 下 如 何在 Flask 中 对 Mongo 
进行 操作 。 

首先 ， 需要 安装 Flask-PyMongo 库 ， 使 用 命令 pip install Flask-PyMongo 即 可 进行 安装 ; 
接着 ， 就 可 以 在 Flask 中 引入 并 使 用 Flask-PyMongo 库 了 ， 具 体 代 码 如 下 。 


from fask import Flask 
from flask pymongo import PYMongo 
import json 


app = Flask(_ name ) 
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mongo = PyMongo (app) 


Qapp.route('/', methods=['GET']) 

def index(): 
active user = mongo.db.users.find({'status': 'active'}) 
return json.dumps (active user) 


在 代码 中 使 用 mongo = PyMongo(app) 来 获取 Mongo 数据 库 实例 对 象 ， 然 后 在 index 处 
理 函 数 中 对 该 对 象 的 users 集 合 进行 了 一 次 查询 操作 ， 查 询 条 件 为 status 字段 为 active 的 记 
录 ， 最 后 返回 查询 结果 。 

细心 的 读者 可 能 会 发 现 ， 这 里 并 没有 设置 任何 的 Mongo 数据 库 连 接 信息 ， 为 什么 也 能 
查询 到 结果 呢 ? 其 实 上 述 代 码 中 的 内 容 是 需要 在 一 个 默认 的 前 提 下 才能 执行 成 功 。 这 个 前 提 
是 假设 Mongo 数据 库 服 务 安装 在 本 机 ， 并 且 监 听 的 是 27017 端口 ， 此 外 还 需要 有 一 个 名 字 为 
app.name 的 数据 库 和 名 字 为 users 的 集合 。 

那么 问题 来 了 ， 如 何 连接 一 个 已 经 存在 的 且 结构 已 知 的 数据 库 呢 ? 答案 就 是 通过 app. 
config 对 象 来 设置 具体 的 Mongo 连接 信息 。 基 本 的 Mongo 连接 设置 如 下 。 

口 MONGO_HOST: Mongo 服务 所 在 IP。 

口 MONGO_PORT: Mongo 服务 监听 的 端口 。 

口 MONGO_DBNAME: 需要 连接 的 Mongo 数据 库 名 。 

口 MONGO_USERNAME: Mongo 数据 库 登 录 名 。 

口 MONGO_PASSWORD: Mongo 数据 库 登 录 密 码 。 

所 以 如 果 现 在 希望 连接 本 地 机 器 、 默 认 端 口 Mongo 服务 的 apiman 数据 库 ， 则 需要 配置 
的 app.config 示例 如 下 。 


app = Flask(_ name_) 
app.config['MONGO_HOST'] IoD Ou 
app.config['MONGO_PORT'] 27017 
app.config['MONGO_DBNAME'] = 'apiman' 
mongo = PyMongo (app) 


此 外 ,更 简洁 的 配置 方式 还 可 以 如 以 下 代码 所 示 ， 效果 是 一 样 的。 


app = Flask(_ name_) 
app.config['MONGO_DBNRAME '] = 'apiman' 
mongo = PyMongo (app) 


因为 我 们 连接 的 是 本 地 机 器 的 默认 端口 ， 所 以 可 以 不 用 设置 而 直接 使 用 默认 值 即 可 。 当 
数据 库 连 接 信息 设置 正确 之 后 ,就 可 以 在 所 有 的 请 求 处 理 函 数 中 直接 使 用 mongo 对 象 了 ， 并 
且 mongo.db 代表 的 就 是 连接 时 设置 的 数据 库 对 象 ， 这 里 就 是 apiman 数据 库 对 象 。 

所 以 当 我 们 需要 查询 apiman 数据 库 中 的 testresult 集合 中 的 记录 时 ， 就 可 以 使 用 下 面 的 
语句 来 查询 。 
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mongo.db.testresult .find ({}) 
关于 更 多 Mongo 数据 库 操作 的 样 例 ， 在 后 面 的 Web 服务 开发 章节 会 继续 介绍 。 这 里 只 
了 解 下 在 Flask 中 如 何 配 置 和 使 用 Mongo 即 可 。 


4. 处 理 结果 返回 
当 用 户 请 求 的 业务 逻辑 被 处 理 结束 之 后 ， 就 可 以 向 请 求 端 反 馈 处 理 后 的 结果 ; 返回 的 具 


体内 容 需 要 根据 不 同 的 业务 需求 来 定制 ， 例 如 ， 可 以 返回 纯 文本 符 串 ， 也 可 以 返回 HTML、 
JSON 等 字符 串 ， 甚 至 可 以 返回 一 个 空 串 或 者 是 一 个 文件 。 


中 返 


在 前 面 的 样 例 代码 中 返回 的 内 容 基 本 都 是 纯 文本 类 型 的 ， 所 以 可 以 直接 在 请 求 处 理 函 数 
回 即 可 ， 最 简单 的 结果 返回 可 以 是 如 下 所 示 的 形式 。 


Qapp.route('/') 
def index(): 
return 'Hello World' 


这 里 返回 的 就 是 纯 文本 内 容 ， 并 且 每 次 返回 的 文本 内 容 都 是 固定 的 ， 如 果 希 望 返 回 的 内 


容 和 请 求 的 数据 有 关联 的 话 ， 也 是 可 以 根据 请 求 内 容 返 回 动态 结果 的 。 具 体 看 如 下 代码 。 


回 的 


Qapp.route('/<name>') 
def index (name): 
return 'Hello %s' % name 


上 述 代码 会 根据 请 求 路 径 的 内 容 来 返回 对 应 的 结果 ， 例 如 ， 访 问 的 URL 为 /tily， 则 返 
内 容 为 Hello lily。 运 行 该 代码 之 后 浏览 器 访问 效果 如 图 14-7 所 示 。 


[i le cm 
DY localhost 
€ > © || localhosts000/ucy 廊 | 国 |: | 
Hello lucy 二 EL > 
/ 口 ecalhoxt8000/iy x B 
€ 了 C |OIocanhostsoooniy 女 | 画 | 
Hello tily ”基于 I ge rd 
/ DY tocalhostao00/Tom x \ 
€ > © [Olocahostao00/Tom 人 加 


Hello Tom 


图 14-7 动态 参数 运行 效果 


样 ， 
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当然 ， 也 可 以 返回 HTML 内 容 ， 这 样 就 可 以 在 浏览 器 中 被 正确 地 演 染 出 效果 ; 和 前 面 一 
HTML 内 容 也 是 可 以 直接 返回 ， 示 例 代码 如 下 所 示 。 


Qapp.route('/<name>') 
def index (name): 
return '<hl>Hello %s</hl>' % name 


代码 中 把 返回 内 容 添加 到 HTML 标签 中 ,就 可 以 组 成 HTML 格式 的 内 容 ， 然 后 再 返回 


该 HTML 内容。 浏览 器 执行 后 的 效果 如 图 14-8 所 示 。 


/DY localhostaoo0/Tom x NO 
GC |@® localhost8000/Tom 全 | 本 : 


Hello Tom 


图 14-8 ”CSS 样式 演示 效果 
同样 地 ， 使 用 相同 的 方式 还 可 以 返回 JSON、XML 等 格式 的 返回 结果 。 看 上 去 我 们 已 经 


可 以 返回 任意 类 型 的 结果 了 ， 但 是 实际 上 还 有 一 个 问题 没有 解决 ， 那 就 是 如 果 返 回 内 容 非 常 
多 ,还 是 直接 在 请 求 处 理 函 数 中 拼接 字符 串 来 返回 结果 的 话 ， 那 么 请 求 处 理 函 数 就 会 变 得 非 
常 腾 肿 。 


对 于 这 种 情况 ， 需 要 把 返回 结果 的 内 容 存 放 到 独立 的 文件 中 ， 然 后 在 请 求 处 理 函 数 中 


根据 文件 路 径 来 读 取 具体 内 容 ， 最 终 返 回 读 取 到 的 结果 内 容 。 所 以 之 前 的 代码 可 以 改 成 如 下 
形式 。 


##result .html 
<hl>Hello %s</h1l> 


##apiweb .py 
Qapp.route('/<name>') 
def index (name) : 
return open('result.html', 'r').read() % name 


这 里 把 需要 返回 的 结果 字符 串 提取 到 result.html 文件 ， 在 真正 返回 结果 的 时 候 就 会 读 取 


result.html 文件 中 的 内 容 ， 并 且 在 格式 化 之 后 返回 给 请 求 端 ， 这 样 即使 需要 返回 的 内 容 非常 
多 ， 也 不 会 影响 请 求 处 理 函 数 中 代码 的 可 读 性 ， 并 且 在 修改 result.html 文件 时 也 无 须 修改 代 
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码 。 而 这 就 是 Web 框架 中 模板 演 染 技术 的 原型 。 

在 Flask 中 需要 使 用 模板 泻 染 技 术 ， 只 要 引入 render template 方法 即 可 ， 通 过 该 方法 
我 们 也 可 以 通过 文件 名 就 将 文件 中 的 内 容 返 回 给 请 求 端 。render_ template 方法 的 使 用 示例 
如 下 。 


from flask import Flask 
from flask import render template 


app = Flask(_ name ) 


Qapp.route('/<name>') 
def index (name): 
return render template('result.html', name=name) 


上 述 代 码 中 ，render_template 方法 不 仅 接受 文件 名 ， 还 可 以 接受 需要 格式 化 的 变量 作为 
参数 。 另 外 ，Flask 的 模板 演 染 技术 使 用 的 是 JinJia2 模板 引擎 ， 所 以 需要 把 result.html 文件 
中 的 内 容 修改 为 符合 JinJia2 的 语法 规则 ， 修 改 后 的 result.html 内 容 如 下 。 

<hl>Hello {{name}}</hl> 

最 后 需要 注意 的 是 ， 在 Flask 中 模板 文件 需要 存在 指定 的 templates 目录 下 ， 这 样 才能 
保证 Flask 有 明确 的 位 置 去 查找 模板 文件 。 在 本 文中 模板 文件 和 主 程序 文件 的 位 置 情 况 如 下 
所 示 。 

/apiweb.py 


/templates 
/result.html 


提示 ”JinJia2 是 一 个 非常 优秀 的 模板 引擎 ， 在 很 多 的 开源 项 目 中 被 使 用 。 关 于 更 多 的 
JinJia2 模板 的 语法 可 以 参见 其 官方 网 站 ， 这 里 由 于 篇 幅 原因 就 不 再 逐一 介绍 了 ， 其 官网 文档 
地 址 为 : http://docs.jinkan.org/docs/jinja2/。 


14.2 Web 上 启动 用 例 执行 


在 我 们 学 习 和 掌握 了 基本 的 Web 服务 开发 技能 之 后 ， 接 下 来 就 可 以 开始 把 API 命令 行 
工具 转 成 API Web 工具 。 本 节 需 要 达到 的 目标 是 ， 可 以 通过 Web 页 面 来 启动 API 测试 ， 达 
到 与 命令 行 启动 测试 同样 的 效果 。 

为 了 实现 这 一 目标 ， 计 划 需 要 做 的 事项 列表 如 下 。 

〈1 ) 实现 一 个 页 面 接收 运行 参数 。 
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(2 ) 实现 一 个 接口 根据 运行 参数 启动 测试 。 

在 实现 具体 的 业务 逻辑 之 前 ,需要 把 Web 服务 的 基础 结构 搭建 起 来 。 首 先 ， 需 要 设计 三 
个 URL， 并 且 把 它们 绑 定 到 对 应 的 请 求 处 理 函数 ; 其 次 ， 还 要 设置 好 相关 的 配置 信息 ， 例 如 ， 
Mongo 的 连接 信息 ; 最 后 ， 测 试 所 有 的 URL 访问 都 能 正常 返回 内 容 。 依 据 这 些 要 求 ，Web 
服务 开发 的 基础 代码 如 下 。 


##index.html 
<hl>I am in index</h1l> 


##results.html 
<hl>I am in results</hl> 


##apiweb .PY 

from flask import Flask 

from flask import render template 
from flask pymongo import PyMongo 


app = Flask(_ name_) 
app.config['MONGO_ DBNAME'] = 'apiman' 
mongo = PyMongo (app) 


Q@app.route('/') 
def index(): 
return render template('index.html') 


Qapp.route('/testing', methods=['POST']) 
def testing(): 
return "" 


@app.route('/results') 
def status () : 

return render template('results.html') 
a Me = Wal 


app.run (debug=True, host='0.0.0.0', port=8000) 


与 之 对 应 的 文件 目录 结构 如 下 。 


/apiweb.py 
/templates 
/index.html 
/status.html 


上 述 代 码 启动 后 ， 在 浏览 器 执行 的 效果 如 图 14-9 所 示 。 
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Te ii 工 = 


€ 3 C |© localhosta000 立国 : 


I am in index 
3 a- 各 和 图 Elal 1 
7 


€ > © [© ocahoste000/satus | 四 :| 


Iam in status 


图 14-9 不 同 访问 路 径 演示 效果 


14.2.1 ”运行 参数 接收 


有 了 这 个 基础 开发 结构 之 后 ， 我 们 就 可 以 基于 此 来 开发 我 们 的 具体 业务 了 。 本 节 需 要 实 


现 的 目标 是 在 Web 上 来 执行 API 测试。 


的 ， 


首先 要 实现 的 是 通过 Web 页 面 来 接收 测试 运行 参数 ， 这 部 分 的 工作 本 来 是 从 命令 行 传递 
现在 有 了 Web 页 面 之 后 就 可 以 通过 页 面 来 接收 了 ; 所 以 Web 页 面 上 需要 接收 的 参数 与 


命令 行 接收 的 参数 基本 保持 一 致 ， 需 要 接收 的 参数 列表 如 下 。 


口 url: 请 求 URL。 

口 method: 请 求 方法 。 

口 data: 请 求 数据 。 

口 headers: 请 求 头 信息 。 

口 files: 请 求 二 进 制 文件 。 

口 encoding: 请 求 响应 编码 。 

口 check type: 期 望 结果 检查 方式 。 

口 expect: 期 望 结果 。 

口 db_str: 测试 用 例 数据 库 连 接 信息 。 

口 test_name: 测试 用 例 名 过 滤 条 件 ， 仅 用 于 db_str 选项 。 
口 test_priority: 测试 用 例 优先 级 过 滤 条 件 ， 仅 用 于 db_str 选项 。 
口 category: 测试 用 例 分 类 过 滤 条 件 ， 仅 用 于 db_str 选项 。 
口 tag: 测试 用 例 标签 过 滤 条 件 ， 仅 用 于 db_str 选项 。 
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口 version: 测试 用 例 版 本 过 滤 条 件 ， 仅 用 于 db_str 选项 。 

针对 上 述 罗列 的 参数 可 以 把 它们 分 为 两 类 : 一 类 是 用 于 单个 用 例 测 试 场景 的 ， 其 参数 有 
url、method、data、headers 、files、check type、expect、encoding ; 另 一 类 是 用 于 批量 用 例 
测试 场景 的 ， 其 参数 包括 db_str、test_name、test_priority、category、tag、version。 

根据 分 析 得 出 的 需求 ， 接 收 测试 参数 的 界面 应 该 由 两 部 分 组 成 ， 一 部 分 是 单 用 例 测试 
区 ， 另 一 部 分 是 批量 用 例 测试 区 ， 所 以 最 终 页 面 效 果 应 该 如 图 14-10 所 示 。 


= © 1 
py D APIMAN 搜 DEI 只 X WB mm sh 


€ 3 C [© 1270018000 女 ] 加 : 
单 用 例 测试 区 


® URL: 

。 Method : 

。 Data : 

。 Headers : 
。 Files : 

® Encoding : 
。Checkrype : 
。 Expect : 


LE 


批量 用 例 测试 区 


e DB 连接 捉 : ” 反 : morgo:/llocahost27017/apiman 
。 测试 用 例 名 : 支持 模 梯 查询 
。 用 例 优先 级 : 如 :1 
。 用 例 分 类 : 。 如 : 登录 模块 
。 用 例 标签 : ”各 : 冒 类 测 法 
。 用 例 版 本 号 : 如 :1 
IE 


S| 
图 14-10 测试 用 例 模板 页 面 


图 14-10 所 对 应 的 HTML 代码 如 下 所 示 ， 可 以 直接 把 它 复制 到 index.html 文件 中 取代 原 
来 的 内 容 ， 然 后 用 浏览 器 访问 http:/127.0.0.1:8000/ 即 可 。 


<html> 
<head> 
<title>APIMAN 接口 测试 工具 </title> 
<style> 
ul 1 { 
margin : Spx; 
} 
li span { 
display: inline-block; 
width:100px; 
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1i input { 
width:250px; 
} 
</style> 
<script></script> 
</head> 
<body> 
<form action="/testing" method="post" 
enctype="application/x-www-form-urlencoded" target=" blank"> 
<h2> 单 用 例 测试 区 </h2> 
<ul> 
<1li><span>URL: </span><input type="text" name="url"></1i> 
<li><span>Method: </span><input type="text" name="method"></1i> 
<li><span>Data: </span><input type="text" name="data"></1i> 
<li><span>Headers: </span><input type="text" name="headers"></1i> 
<li><span>Files: </span><input type="text" name="files"></1i> 
<li><span>Encoding: </span><input typ text" name="encoding"></1i> 
<li><span>CheckType: </span><input tyP4 
<li><span>Expect: </span><input type="text" name="expect"></1i> 
</ul> 
<input type="submit" value=" 提交 "> 
</form> 
<hr> 
<form action="/testing" method="post" 
enctype="application/x-www-form-urlencoded" target=" blank"> 
<h2> 批量 用 例 测试 区 </h2> 
<ul> 
<1i><span>DB 连接 串 : </span><input type="text" name="db_str" 
Placeholder=" 如 : mongo://localhost:27017/apiman"></1i> 
<1i><span> 测试 用 例 名 : </span><input type="text" name="test_ name" placeholder= 
"支持 模糊 查询 "></1i> 
<1li><span> 用 例 优 先 级 : </span><input type="text" name="test priority" 
placeholder=" 如 : 1"></1i> 
<1i><span> 用 例 分 类 : </span><input type="text" name="category" placeholder= 
" 如: 登录 模块 "></1i> 
<1i><span> 用 例 标签 : </span><input type="text" name="tag" placeholder=" 如 : 
冒 烟 测试 "></1i> 


<1i><span> 用 例 版 本 号 : </span><input type="text" name="version" placeholder= 


text" name="check type"></1i> 


"i L52711> 
</ul> 
<input type="submit" value=" 提交 "> 
</form> 
</body> 
</html> 


上 述 代码 中 绘制 了 两 个 form 表单 ， 分 别 用 来 提交 单 用 例 测试 数据 和 批量 用 例 测试 数据 ; 
并 且 两 个 表单 都 提交 给 了 /testing 这 个 URL 来 处 理 。 另 外 ， 提 交 表 单 完成 后 会 在 新 开 的 页 面 
显示 响应 内 容 。 
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14.2.2 ”测试 请 求 处 理 

现在 继续 开发 测试 请 求 处 理 的 相关 逻辑 ， 即 对 /testing 所 对 应 的 处 理 函 数 进行 相关 业务 
处 理 。 第 一 步 要 做 的 就 是 对 请 求 参数 进行 接收 与 验证 ， 因 为 只 有 在 获取 到 有 效 的 运行 参数 之 
后 ,才能 正确 执行 相关 的 测试 ， 这 部 分 的 代码 如 下 。 


from flask import request 
from apiservice import * 
import json 


@app.route('/testing', methods=['POST']) 
def testing() : 
data = request.form 
if data.get ('db_str'): 
db_str = data.get('db_str') 
if db str: 
result = do testing with db (data) 
elif data.get('url') and data.get ('url'): 
Url = data.get('url') 
method = data.get('method') 
if url and method: 
result = do testing with data(data) 
else: 
result = {'error code' : -1, 
"error_msg' : ' 请 求 数据 错误 !'} 


return json.dumps (result) 

代码 中 对 于 表单 中 的 请 求 参数 ， 可 以 通过 request.form 对 象 获取 。 对 于 参数 的 判断 逻辑 
为 ， 如 果 有 db_str 参数 且 非 空 ， 则 认为 是 批量 测试 请 求 ; 而 如 果 有 url 和 method 参数 ， 则 认 
为 是 单 次 测试 请 求 。 

具体 的 批量 和 单 次 请 求 处 理 逻 辑 ， 分 别 封装 在 do_testing_with db、do_testing_with_data 
这 两 个 方法 中 。 这 两 个 方法 都 是 从 apiservice 模块 中 导入 。 现 在 就 来 看 下 这 两 个 方法 的 具体 
实现 ， 详 情 代 码 内 容 如 下 。 

#!/usr/bin/env python 

# -*- coding: utf-8 -*- 


import json 
from demo api import main 


def do testing with dbl(args): 
try: 
return main (args) 
except Exception, ex: 
print ex.message 
return {'error code' : -2, 
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"error_ msg' : ' 执行 批量 测试 任务 异常 !' } 


def do testing with datal(largs): 
try;: 
if args.get('"'files'): 
£f list = args.get('files') .split(',') 
args['files'] = [tuple(f.split(':')) for f in 上 list] 
if args.get('data'): 
try: 
args['data'] = json.loads (args.get('data')) 
except: 
pass 
if args.get('headers') : 
toys 
args['headers'] = 
json.loads (args.get ('headers')) 
except Exception, ex: 
print ex.message 
return {error code' 3: -3y 
"error_msg' : ' 解析 请 求 头 异常 !'} 
return main(args) 
except Exception, ex: 
print ex.message 
return {'error code' : -4, 


"error_msg' : ' 执行 单 次 测试 任务 异常 !'} 


上 述 代码 中 ， 针 对 单 次 测试 请 求 ， 需 要 先 对 data、files、headers 进行 参数 的 序列 化 ， 作 
用 同 命 令 行 的 参数 处 理 功 能 ， 最 后 得 到 的 请 求 参 数 与 命令 行 得 到 的 数据 保持 一 致 ， 所 以 就 可 
以 直接 引入 第 13 章 中 API 工 具 中 的 main 方法， 在 把 处 理 过 的 请 求 参 数 传递 给 main 方法 ; 
在 这 之 后 的 所 有 逻辑 均 与 命令 行 启动 的 测试 保持 一 致 流程 。 


这 里 还 需要 注意 的 一 点 是 ， 页 面 上 接收 的 fles、headers 参数 与 命令 行 有 些许 


行 中 


Ph 可 以 通过 多 次 -f、-H 参数 来 设 定 多 个 fles 和 headers 参数 ， 而 页 面 上 它们 都 


区 别 。 命 令 


只 有 一 个 输 


入 域 ， 所 以 对 页 面 上 的 fles、headers 参数 格式 进行 了 修改 。 修 改 后 的 files 参数 格式 如 下 。 


fieldl:1.jpg:image/jpgefield2:2.png:image/png 


即 先 通 过 @ 符号 来 分 隔 出 多 个 fle 参 数 ， 再 对 每 一 个 fle 参数 进行 序列 化 分 隔 ; 而 
headers 参数 格式 则 修改 为 所 有 请 求 头 存放 在 一 个 JSON 串 中 ， 具 体 如 下 所 示 。 


4 
"Content-Type": "application/x-www-form-urlencoded", 
"refer"s "looalhoat™ 


} 
最 后 ,一 个 单 次 API 的 GET 请 求 示例 如 图 14-11 所 示 。 
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. = [加 一 一 
 D APIMANSCREAIR x ee 


C 1@D12700.18000 女 | 国 3: 


URL: ep /hpbin orgfget 了 
» Method: [ger 
。 Data : [ 


ed | 
| 


单 用 例 测试 区 | 


Files : 
。Encoding 

。 Checkrype : 
。 Expect : 


| 提交 | 
图 14-11 单 API 测试 执行 样 例 


提示 使 用 files 参数 时 ， 需 要 保证 填写 的 文件 路 径 在 Web 服务 器 是 可 访问 的 ， 否 则 
Web 服务 器 发 送 API 请 求 时 会 因 无 法 读 取 到 文件 路 径 而 报错 。 


14.3 Web 上 查看 测试 结果 


如 果 已 经 选择 要 在 Web 上 来 执行 测试 的 话 ， 那 么 查看 执行 结果 也 是 需要 在 Web 上 来 进 
行 的 ， 本 节 简 单 介 绍 下 如 何在 Web 上 来 查看 执行 结果 。 

在 13.6 节 中 ,已 经 介绍 过 如 何 记录 测试 结果 ， 而 这 里 就 来 介绍 下 如 何 读 取 这 些 结果 并 展 
示 在 Web 页 面 上 。 首 先 ， 需 要 回顾 一 下 之 前 保存 测试 结果 的 数据 结构 ， 代 码 如 下 。 


{ 


"task name" : test data.get('task name'), 
"project name" : test data.get('project name'), 
"testcase name" : test data.get('name'), 
"category" : test data.get('category'), 
"version" : test data.get('version'), 

"result" : test data.get('result'), 

"time" : int (time.time()) 


} 


从 代码 中 可 以 知道 ， 测 试 结果 保存 的 字段 有 任务 名 、 项 目 名 、 测 试用 例 名 、 分 类 、 版 
本 、 测 试 执行 结果 、 测 试 执行 时 间 等 。 其 中 ,任务 名 是 用 来 代表 同一 批 次 执行 的 测试 用 例 结 
果 集 合 ， 查 看 执行 结果 的 时 候 就 是 通过 这 个 任务 名 来 确定 的 ， 默 认 这 个 任务 名 为 启动 测试 时 
的 时 间 戳 。 例 如 ， 在 1499092786 这 个 时 间 惟 ， 执 行 了 一 次 批量 测试 ， 该 批 次 的 所 有 测试 用 
例 结果 都 会 被 记录 到 1499092786 这 个 任务 名 下 ， 后 期 需要 查看 这 次 测试 执行 的 结果 时 ， 需 
要 先 找到 这 个 任务 名 ， 再 通过 这 个 任务 名 就 可 以 查看 到 所 有 的 测试 结果 。 
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那么 ，Web 上 要 如 何 展示 测试 结果 呢 ? 根据 之 前 的 分 析 ， 应 该 是 先 罗列 出 所 有 的 执行 任 
务 列表 ,用户 再 通过 单 击 任务 名 来 查看 该 任务 名 下 的 所 有 测试 结果 ， 所 以 需要 至 少 以 下 两 个 
页 面 。 

口 任 务 列表 页 。 

口 用 例 结果 页 。 


14.3.1 任务 列表 页 


为 了 实现 任务 列表 页 ， 根 据 之 前 介绍 过 的 Web 服务 开发 流程 ， 分 别 需要 执行 的 步骤 有 以 
下 几 个 。 

(1) 添加 URL 映射。 

(2 ) 添加 请 求 处 理 函 数 。 

(3 ) 添加 模板 文件 。 

这 里 设 定 URL 为 /task， 其 对 应 的 处 理 函 数 为 task， 则 URL 的 映射 配置 代码 如 下 所 示 。 


Qapp.route('/task') 
def task(): 
pass 


上 述 代码 中 ，task 处 理 函 数 未 做 任何 处 理 ， 也 未 返回 任何 内 容 ， 所 以 需要 给 task 函数 添 
加 相关 的 处 理 逻 辑 。 首 先 需要 获取 任务 列表 页 要 展示 的 任务 数据 ， 即 按照 先前 的 设计 存放 在 
task 表 中 的 记录 ， 读 取 task 表 数 据 的 代码 如 下 。 


def get task list(): 
return read mongo(collection='task') 


@app.route('/task') 
def task() : 
tasks = get task list() 


接着 要 添加 在 前 端 展示 的 HTML 模板 ， 这 里 新 建 一 个 名 为 task.html 的 模板 文件 ， 具 体 
的 HTML 示例 代码 如 下 。 


<html> 
<head> 
<title>APIMAN 接口 测试 工具 </title> 
<style> 
Wl 1 
margin : Spx; 
} 
li span { 
display: inline-block; 
width:100px; 
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} 
1i input { 
width:250px; 
S 
</style> 
<script></script> 
</head> 
<body> 


<h2> 任务 列表 </h2> 
<ul> 
{% for task in tasks $%} 
<1i> 
<a href="/result?task name={{task.name}}"> 
{{task.name}} 


</a> 
</1i> 
{% endfor 要 } 
</ul> 
</body> 
</html> 
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现在 task 数据 和 展示 模板 都 已 经 有 了 ， 剩 下 的 操作 就 是 把 它们 关联 到 一 起 ， 其 关联 的 代 


码 如 下 。 
@app.route('/task') 
def task(): 


tasks = get task list() 
return render template('task.html', tasks=tasks) 


最 后 ， 所 有 代码 都 完成 后 的 执行 效果 ， 如 图 14-12 所 示 。 


六 APIMAN 接 口 测试 共 x 


€ [ed | © localhost:8000/task 


图 14-12 测试 任务 列表 
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提示 这 里 能 够 列 出 任务 列表 的 前 提 是 MongoDB 库 的 task 表 中 已 经 存在 记录 ， 否 则 只 
显示 一 个 空 列表 。 


14.3.2 ”用 例 结果 页 


在 任务 列表 页 只 要 单 击 任意 一 个 任务 名 链接 ， 就 会 跳 转 到 该 任务 名 下 绑 定 的 测试 用 例 结 
果 页 面 。 这 个 页 面 的 访问 地 址 为 /result?taskname={{task.name}}， 其 中 ，task.name 参数 代表 
具体 的 任务 名 。 

按照 惯例 ， 需 要 先 添加 一 个 URL 与 处 理 函 数 的 映射 关系 ， 其 代码 如 下 。 


Q@app.route('/result') 
def result(): 
pass 


然后 要 实现 result 处 理 函 数 中 的 逻辑 : 读 取 result 数 据 。 展 示 在 result 模板 中 。 读 取 
result 数据 的 代码 如 下 。 


def get result list(task name): 
condition = {'task name' : task name } 
return read mongol(collection='testresult', 
condition= condition 


Qapp.route('/result') 
def result(): 
task name = request.args.get('task name') 
if task name: 
results = get result list(task name) 
else: 
results = [] 
return render template('result.html', results=results) 


展示 result 的 模板 内 容 如 下 ， 这 里 将 保存 在 resulthtml 文件 中 。 


<html> 

<head> 
<title>APIMAN 接口 测试 工具 </title> 
<style> 


</style> 
<script></script> 
</head> 
<body> 


<h2> 用 例 结果 页 </h2> 
<table> 
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<tr> 
<th> 任务 名 </th> 
<th> 项 目 名 </th> 
<th> 用 例 名 </th> 
<th> 分 类 </th> 
<th> 版 本 </th> 
<th> 执行 结果 </th> 
<th> 执行 时 间 </th> 
</tr> 
{% for result in results %} 
<tr> 
<td>{{result.task name}}</td> 
<td>{{result.project name}}</td> 
<td>{{result.testcase name}}</td> 
<td>{{result.category}}</td> 
<td>{{result.version}}</td> 
<td>{{result.result}}</td> 
<td>{{result.time}}</td> 
</tr> 
{% endfor %} 
</table> 
</body> 
</html> 


关联 result 数据 与 模板 的 代码 如 下 。 


Qapp.route('/result') 
def result(): 
results = get_ result_ list() 
return render template('result.html', results=results) 


最 后 ， 完 成 全 部 代码 后 的 运行 效果 如 图 14-13 所 示 。 


口 APIMAN 近 DRI x 
€ © | © localhost:8000/result?task_name=task_1 廊 色 0 


用 例 结果 页 


任务 名 项 目 名 ” 用 例 名 。 分 类 版 本 执行 结果 ”执行 时 间 

task 1 None testcase 01 login 1 True 1499253640 
task_1 None testcase 02 login 1 True 1499253741 
task 1 None testcase 03 login 1 True 1499253818 
task 1 None testcase 04 login1 True 1499253946 


图 14-13 ”测试 结果 页 面 
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14.4 持续 集成 的 API 自动 化 测试 


正如 前 面 提 到 过 的 ，API 自动 化 测试 的 投入 产 出 比较 高 ， 可 作为 常规 的 自动 化 测试 来 覆 
盖 相 关 功 能 点 ， 因 此 API 自动 化 测试 也 应 当 需 要 支持 持续 集成 开发 流程 。 例 如 ， 每 次 提交 代 
码 时 执行 一 次 API 的 冒 烟 测试 用 例 ， 每 天 daily build 之 后 要 执行 一 次 API 的 主 功能 用 例 。 

为 了 方便 接 人 持续 集成 的 开发 流程 中 ，API 工具 需要 提供 一 个 良好 的 启动 测试 的 接口 ， 
这 样 在 持续 集成 的 系统 中 就 可 以 很 方便 地 调用 对 应 的 接口 来 启动 不 同 的 测试 任务 。 由 于 我 们 
已 经 把 API 工具 接 人 到 Web 服务 中 ， 所 以 只 要 提供 一 个 额外 的 Web 接口 就 可 以 很 方便 地 达 
到 这 个 目的 。 

要 完成 这 样 一 个 Web 接口 ， 其 实 可 以 有 很 多 种 实现 方式 ， 并 且 我 们 已 经 实现 了 一 种 ， 即 
13.2.2 节 中 的 /testing 处 理 接口 。/testing 接口 可 以 接受 一 组 条 件 ， 并 会 根据 接收 到 的 条 件 来 
查询 测试 用 例 并 执行 。 如 果 直 接 使 用 /testing 接口 ， 则 在 持续 集成 系统 中 调用 启动 测试 接口 
的 样 例 很 可 能 是 如 下 的 样子 。 


curl --data-urlencode "db_str=mongo://127.0.0.1:27017/apimangtest_ name= 
xxx&test priority=l&category=logingtag=smoking&version=1" http://apiman.com/testing 


即 调 用 /testing 接口 时 ， 需 要 附带 很 多 的 组 合 条 件 ; 很 显然 这 不 是 一 个 易 用 性 、 维 护 性 
很 好 的 接口 ， 所 以 需要 单独 开发 一 个 接口 专门 提供 给 持续 集成 系统 使 用 。 而 关于 新 接口 的 设 
计 则 可 以 参考 用 例 结果 集中 的 任务 名 的 概念 ， 即 用 另外 一 个 变量 名 来 绑 定 启动 测试 时 的 所 有 
组 合 条 件 ， 这 里 叫 作 测试 用 例 集 名 。 

所 谓 的 测试 用 例 集 就 是 一 组 测试 用 例 的 集合 ， 具 体 的 测试 用 例 集 名 就 代表 一 组 特定 的 测 
试用 例 。 这 里 只 要 把 测试 用 例 集 名 与 特定 组 合 条 件 进行 绑 定 ， 就 可 以 代表 这 一 组 条 件 所 对 应 
的 用 例 集合 。 因 此 在 绑 定 过 用 例 集 之 后 ， 通 过 Web 接口 启动 测试 的 样 例 就 变 成 下 面 的 样子 。 

curl --data "test_set=smoking" http://apiman.com/api_ testing 

很 显然 改进 后 的 Web 接口 在 易 用 性 上 有 了 很 大 的 提升 ， 并 且 在 需要 修改 用 例 集 条 件 的 时 
候 ， 都 不 需要 修改 调用 代码 ， 而 只 要 修改 用 例 集 对 应 的 组 合 条 件 即 可 。 

那么 ， 下 面 就 来 看 下 实现 通过 用 例 集 名 来 启动 测试 的 接口 需要 完成 哪些 功能 。 

口 实现 一 个 用 例 集 保存 流程 。 

口 实现 一 个 用 例 集 执行 接口 。 


14.4.1 ”用例 集 保存 
首先 ， 需 要 设计 一 个 testset 表 ， 用 来 保存 用 例 集 与 组 合 条 件 的 关系 ， 该 表 的 字段 结构 如 下 。 
{ 


"name": 用 例 集 名 ， 
"db_str": MongoDB 连接 串 ， 
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"test_name": 测试 用 例 名 ， 
"test_priority": 测试 用 例 优先 级 ， 
"category": 测试 用 例 分 类 ， 
"tag": 测试 用 例 标签 ， 
"version": 测试 用 例 版 本 号 

J 


接着 ,需要 新 建 一 个 页 面 来 创建 并 保存 用 例 集 信息 。 为 此 需要 添加 一 组 Web 访问 的 代 
码 ， 具 体 见 如 下 代码 。 


Qapp.route('/testset') 
def test_set(): 
return render templatel('testset.html') 


其 中 ，testset.html 模板 文件 的 内 容 如 下 。 


<html> 
<head> 
<title>APIMAN 接口 测试 工具 </title> 
<style> 
WL 下 
margin : Spx; 
} 
li span { 
display: inline-block; 
width:100px; 
li input { 
width:250px; 
} 
</style> 
<script></script> 
</head> 
<body> 


<form action testset" method="post" 
enctype="application/x-www-form-urlencoded" target 
<h2> 新 建 用 例 集 </h2> 
<ul> 
<1i><span> 用 例 集 名 : </span><input type="text" name="name"></1i> 
<1i><span>DB 连接 囊 : </span><input type= db_str" 
placeholder=" 如 : mongo://localhost:27017/apiman"></1i> 
<1i><span> 测试 用 例 名 : </span><input type="text" name="test_name" placeholder= 
"支持 模糊 查询 "></1i> 
<li><span> 用 例 优 先 级 : </span><input type="text" name="test priority" 
placeholder=" 如 : 1"></1i> 
<1i><span> 用 例 分 类 : </span><input type="text" name 
" 如 : 登录 模块 "></1i> 
<1Li><span> 用 例 标签 : </span><input type="text" name="tag" placeholder=" 如 : 
冒 烟 测试 "></1i> 


blank"> 


"text" name= 


"category" placeholder= 
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<1li><span> 用 例 版 本 号 : </span><input type="text" name="version" placeholder= 
加 1"></11iS 


</ul> 
<input type="submit" value=" 提交 "> 
</form> 
</body> 
</html> 
完成 代码 后 在 浏览 器 中 访问 http://127.0.0.1:8000/testset， 其 效果 如 图 14-14 所 示 。 
=) 5 
J D PMANISOINIR x 
€ SC[D1270018000nestset 立 | 下 : 


新 建 用 例 集 


。 用 例 集 名 : 
。 DB 连接 捉 : 阳 : mongo Wocahost27017/apman 
。 测试 用 例 名 : 计 尘 翁 科 查询 

。 用 例 优先 级 : 如: 1 

。 用 例 分 类 : 。 如 : 本 未 模 权 

。 用 例 标签 : 。 职 : 于 测 旗 

。 用 例 版 本 号 : 即 :1 


EE 


图 14-14 ”测试 用 例 集 创建 


图 14-14 中 用 户 填写 完 用 例 集 相关 信息 之 后 ， 通 过 单 击 “ 提 交 ” 按 钮 ， 即 可 把 数据 提交 
给 Web 服务 器 。 该 表单 提交 的 地 址 为 Htestset， 提 交 的 方式 为 POST ; 因此 后 台 需 要 添加 一 个 
可 以 处 理 该 请 求 的 函数 ， 为 此 需要 修改 代码 为 如 下 所 示 。 


@app.route('/testset', methods=['POST', 'GET']) 
def test set(): 
if request .method=='GET' : 
return render_template('testset.htm1l') 
elif request.method=='POST' : 
data = request.form 
result = save test_set (data) 
if result: 


return json.dumps ({"msg": un 保存 用 例 集 成 功 "}) 


def save test_ set (data) : 
test set = { 

"name": data.get ('name'), 
"db_str": data.get('db str'), 
"test name": data.get('test name'), 
"test priority": data.get('test priority'), 
"category": data.get('category'), 
"tag": data.get ('tag'), 
"version": data.get ('version') 
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return write mongo(collection="testset", record=test set) 


上 述 代码 中 ， 通 过 修改 使 得 test_set 函数 可 以 同时 处 理 GET 和 POST 请 求 。 对 于 GET 
请 求 会 返回 用 例 集 保 存 界面 ， 而 对 于 POST 请 求 则 会 获取 请 求 数 据 并 保存 用 例 集 信息 到 
DB 中 。 


14.4.2 ”用 例 集 执行 


在 可 以 保存 用 例 集 之 后 ， 就 要 开始 考虑 如 何 去 运 行 某 个 特定 的 用 例 集 。 按 照 之 前 的 设 
计 ， 需 要 重新 开发 一 个 接口 来 专门 用 于 用 例 集 的 测试 ， 为 此 我 们 同样 需要 添加 一 套 Web 访问 
的 代码 ，URL 与 处 理 函 数 映射 的 代码 如 下 。 


Qapp.route('/api testing', methods=['POST', 'GET']) 
def api testing(): 
if request.method=='POST': 
test_set = request.form.get('test set') 
else: 
test set = request.args.get('test set') 


上 述 代码 中 ,新建 了 一 个 /api_testing 的 接口 来 执行 用 例 集 测 试 ， 另 外 ， 这 个 接口 可 以 同 
时 支持 GET 和 了 POST 方法， 并 且 会 根据 情况 来 相应 地 获取 test_set 参数 。 
接着 ， 需 要 根据 传递 的 test_set 参数 来 获取 对 应 的 用 例 集 条 件 ， 相 关 代码 如 下 。 


def get condition by test set(test set): 
condition = {'name' : test_set} 
r= read mongol(collection='testset', condition=condition) 
县 
return r[0] 


最 后 ， 还 需要 把 获取 到 的 用 例 集 条件 传 递 给 具体 的 执行 函数 ， 通 过 该 函数 来 启动 整个 用 
例 集 的 测试 。 完 整 的 调用 代码 如 下 。 


Qapp.route('/api_ testing', methods=['POST', 'GET']) 
def api testing(): 
if request .method=='POST' : 
test_set = Tequest.form.get('test_set') 
else: 
test_set = request.args.get('test set') 
condition = get condition by test set(test set) 
if condition: 
result = do testing with db(condition) 
else: 
result = {'error code': -5，'error msg': u' 获取 测试 数据 失败 !'} 
return json.dumps (result) 
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上 述 代 码 中 ， 把 获取 到 的 用 例 集 条 件 传 递 给 了 do_testing_with_db 函数 ， 该 函数 是 前 期 
API 工具 中 已 经 实现 好 的 功能 函数 ， 所 以 这 里 可 以 直接 调用 。 

完成 所 有 代码 之 后 ， 就 可 以 通过 新 增 的 接口 来 启动 用 例 集 测试 了 。 一 般 情况 下 ， 调 用 该 
接口 的 方式 可 以 用 如 下 的 GET 形式 。 

curl http://apiman.com:8000/api testing?test set=smoking 

或 者 是 下 面 的 POST 形式 。 

curl --data "test set=smoking" http://apiman.com/api testing 

现在 ,我 们 的 API 工具 就 可 以 很 方便 地 集成 到 持续 开发 流程 中 了 ， 只 要 在 构建 流程 之 后 
调用 一 下 用 例 集 测 试 接口 即 可 。 


说 明 由 于 篇 幅 有 限 ， 本 章 仅 对 相关 的 必要 知识 进行 介绍 与 使 用 ， 对 于 CSS、JS、 
HTML 等 技术 未 做 相关 介绍 和 过 多 引用 ， 对 于 不 熟悉 相关 知识 的 读者 还 需要 自行 查阅 资料 。 


关于 本 章 中 的 全 部 实例 代码 ， 请 至 GitHub 站 点 进行 下 载 ， 完 整 的 下 载 地 址 为 https:/ 
github.com/five3/python-Selenium-book/tree/master/apiman。 本 章 所 介绍 的 这 个 版 本 的 工具 还 
是 一 个 雏形 ， 如 果 读 者 准备 在 生产 环境 中 正式 使 用 ， 还 需要 对 其 进行 更 多 的 完善 和 优化 ; 同 
时 后 期 也 会 同步 优化 该 API 工具， 想 要 及 时 获取 最 新 版 的 读者 ， 可 以 加 入 在 testqa.cn 上 的 
“Python Web 自动 化 测试 设计 与 实现 ”小 组 获取 最 新 版 本 更 新 消息 。 


CHAPTER 


第 15 章 1 
HTTP Mock 开发 


Mock 是 指 一 种 模仿 对 象 的 行为 ， 在 计算 机 中 特 指 模仿 程序 对 象 的 行为 ， 具 体 到 我 们 的 
Web API 就 是 模仿 Web API 的 行为 。 之 所 以 需要 这 样 一 种 模仿 的 行为 ， 是 因为 我 们 暂时 性 地 
无 法 获取 到 真实 的 对 象 行为 ， 例 如 ， 所 需 服 务 还 没 开发 完成 、 所 需 服务 为 客户 生产 环境 服务 
无 法 提供 测试 环境 、 真 实 对 象 很 难 被 创建 、 真 实 对 象 行为 不 可 控 等 。 

由 于 这 些 原 因 ， 可 能 就 会 导致 我 们 在 测试 Web API 时 陷入 困境 。 如 果 没有 经 过 充分 的 测 
试 ， 我 们 的 产品 代码 是 不 能 完成 上 线 操作 的 。 为 了 解决 这 类 测试 问题 ， 所 以 就 引入 了 Mock 
的 概念 ， 使 用 Mock 对 象 来 模拟 真实 对 象 或 者 服务 的 行为 ; 并 且 Mock 对 象 的 逻辑 非常 简单 ， 
即 对 于 特定 的 输入 它们 总 会 返回 特定 的 输出 ， 而 输入 和 输出 之 间 直 接 通 过 映射 关系 对 应 好 就 
可 以 了 ， 并 没有 真实 的 业务 逻辑 存在 。 


15.1 HTTP Mock 介绍 


了 解 Mock 的 概念 之 后 ， 再 来 具体 说 说 HTTP Mock。 简 单 来 说 就 是 基于 HTTP 的 Mock 
行为 ， 即 这 个 Mock 的 对 象 是 一 个 Web 服务 。 之 前 介绍 过 的 Web API 就 是 一 种 Web 服务 ， 
所 以 也 可 以 把 HTTP Mock 直接 理解 为 模仿 Web API 的 程序 。 

例如 ， 现 在 需要 开发 一 个 支付 的 接口 ， 这 个 接口 会 去 调用 银行 的 转账 接口 ， 之 后 会 返回 
对 应 的 调用 结果 ， 我 们 再 根据 银行 接口 的 返回 内 容 进 行 相应 的 处 理 。 如 果 在 测试 环境 下 ， 我 
们 在 调试 或 者 单元 测试 时 也 调用 真实 的 银行 接口 ， 容 易 造 成 一 些 脏 数据 和 不 必要 的 麻烦 。 
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此 时 就 可 以 开发 一 个 模仿 银行 转账 接口 的 HITP Mock， 它 的 主要 功能 就 是 接收 HTTP 
请 求 ， 根 据 请 求 的 URL 返回 其 对 应 的 固定 内 容 。 我 们 只 要 在 测试 环境 里 把 银行 接口 的 请 求 
URL 替换 为 定制 的 HTTP Mock 地 址 的 URL 即 可 达到 测试 的 效果 。 


15.2 HTTP Mock 分 析 


为 了 能 够 模仿 Web API 服务 的 功能 ，HTTP Mock 需要 有 一 个 最 基本 的 功能 ， 那 就 是 需 
要 能 够 提供 一 个 基础 的 Web 服务 的 能 力 。 即 首先 它 可 以 接收 HTTP 请 求 ， 其 次 它 可 以 获取 到 
请 求 URL 的 具体 路 径 和 请 求 数据 ， 最 后 它 可 以 返回 任意 类 型 的 响应 内 容 。 

针对 HTTP Mock 所 需 的 基本 功能 ， 再 结合 第 14 章 中 介绍 的 Web 服务 ,我 们 可 以 很 
容易 得 知 ， 直 接 使 用 Web 框架 就 可 以 满足 我 们 的 所 有 基本 需求 ; 我 们 只 要 把 重点 放 到 请 求 
URL 和 响应 内 容 的 映射 关系 上 即 可 。 最 简单 的 HTTP Mock 程序 可 以 是 如 下 所 示 的 示例 。 

#!/usr/bin/env Python 

i wn bf ms 

import json 


from flask import Flask, request 
app = Flask(_name_) 


@app.route('/') 
def index(): 
return 'Welcome to HTTP Mocker!' 


Qapp.route('/transfer/') 
def transfer(): 
data = request.args 


if data: 
return json.dumps ({"success" : True}) 
else: 
return json.dumps({"success" : False}) 
if name _ == "main_"; 


app.run (debug=True) 


上 述 代 码 中 只 实现 了 一 个 Mock 函数 功能 ， 这 个 transfer 函数 接收 GET 请求， 并且 在 附 
带 请 求 参 数 的 情况 下 返回 成 功 ， 而 不 带 请 求 参 数 的 时 候 则 返回 失败 ; 这 里 面 成 功 和 失败 的 内 
容 可 以 任意 定制 ， 在 实际 项 目 中 则 需要 与 被 模仿 服务 的 返回 内 容 保 持 一 致 。 例 如 ， 被 模仿 的 
服务 在 请 求 成 功 时 会 返回 一 个 订单 号 ,需要 把 成 功 时 返回 的 内 容 修改 为 如 下 形式 。 

return json.dumps ({"success" : True, "orderNo" : "DD20170514112" }) 

同样 还 可 以 注意 到 这 个 Mock 函数 返回 的 内 容 是 固定 的 ， 如 果 需 要 返回 不 同 的 内 容 则 需 
要 手动 更 改 代码 。 另 外 ，Mock 函数 中 对 返回 内 容 的 判断 条 件 也 是 固定 的 ， 所 以 这 样 的 一 个 
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功能 单一 的 Mock 程序 在 业务 扩展 上 是 不 够 友好 的 。 
如 果 需 要 设计 一 个 业务 扩展 性 比较 好 的 HTTP Mock 程序 ， 那 么 它 应 该 需要 包括 哪些 功 
能 呢 ? 
首先 ， 它 可 以 根据 请 求 URL 来 确定 返回 的 内 容 。 
其 次 ， 它 可 以 根据 请 求 方法 来 确定 返回 的 内 容 。 
再 次 ， 它 可 以 根据 请 求 头 来 确定 返回 的 内 容 。 
最 后 ， 它 可 以 根据 请 求 的 参数 来 确定 返回 的 内 容 。 
也 就 是 说 ， 一 个 业务 扩展 性 较 好 的 HTTP Mock， 可 以 依据 HTTP 请 求 的 各 个 要 素来 确 
定 具 体 的 返回 内 容 ; 并 且 这 些 请 求 要 素 组 合 与 返回 内 容 之 间 的 映射 关系 可 以 通过 配置 来 完 
而 不 应 该 是 通过 修改 代码 来 完成 。 


15.3 HTTP Mock 实现 


通过 15.2 节 的 分 析 ， 我 们 了 解 了 一 个 功能 良好 的 HTTP Mock 程序 应 该 具备 的 基本 功能 ; 
这 些 基本 功能 都 是 对 HTTP 请 求 要 素 进 行 过 滤 的 操作 ， 通 过 过 滤 这 些 要 素来 确定 HTTP Mock 
是 和 否 提供 了 对 应 的 服务 ， 以 及 服务 应 该 返回 什么 内 容 。 本 节 介绍 下 如 何 实现 这 些 基本 功能 。 


15.3.1 根据 请 求 URL 过 滤 

假设 我 们 需要 Mock 一 个 日 期 接口 服务 ， 该 服务 会 根据 不 同 的 请 求 URL 来 返回 不 同 的 
日 期 信息 ， 例 如 ，/date/year 返回 当前 年 份 , /date/month 返回 当前 月 份 等 ， 那 么 我 们 的 Mock 
程序 就 需要 支持 针对 不 同 的 URL 模拟 返回 对 应 响应 内 容 。 

首先 ， 需 要 在 Web 服务 中 获取 到 请 求 URL 的 具体 值 ， 其 实现 见 如 下 代码 。 


Qapp.route('/<path:url>') 
def dispatch (url): 
return url 


代码 中 通过 '/<path:url>' 路 由 匹配 规则 来 获得 具体 的 URL 请 求 路 径 并 赋值 给 url 变量 ， 
例如 ， 用 户 访 问 http://localhost:5000/test 则 url 的 路 径 为 test， 用 户 访问 http://localhost:5000/ 
test/for/python 则 url 的 路 径 为 test/for/python。 
其 次 ， 还 需要 一 个 URL 与 返回 内 容 关联 的 映射 表 ， 该 映射 表 主 要 用 来 维护 URL 与 返回 
内 容 之 间 的 对 应 。 例 如 ， 针 对 日 期 接口 的 Mock 程序 其 映射 表 结 构 可 以 参考 下 面 的 样式 。 
MOCK_MAPPING = { 


"date/year": { 
"default": {"year": "2017"} 


}, 
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"date/month": { 
"default": {"month": "05"} 
}, 
"date/day": { 
"default"s {1"day": "14"} 
} 
"date/week": { 
"default": {"week": "Sunday"} 
} 
"default": “URL Not Found" 


} 


从 映射 表 中 可 以 看 到 ， 每 一 个 url 都 对 应 了 一 个 默认 的 返回 内 容 ，Mock 程序 将 会 依据 这 
个 映射 表 来 对 请 求 做 出 对 应 的 响应 。 最 后 对 URL 支持 过 滤 的 完整 代码 如 下 所 示 。 


#!/usr/bin/env Python 

mh podLng: Gtr = 

import json 

from flask import Flask, request 
app = Flask(_ name_) 


Q@app.route('/<path:url>') 
def dispatch (url): 
url = url.rstrip('/') 
if url in MOCK_ MAPPING: 
return 
else: 
return MOCK MAPPING['default'] 
if name == ' main ': 
app.run (debug=True) 


上 述 代码 在 dispatch 函数 中 对 请 求 url 进行 了 过 滤 操 作 ， 如 果 url 存在 于 映射 表 中 则 返回 
运行 上 述 代码 后 用 户 在 浏览 器 中 进行 


配置 的 默认 信息 ， 如 果 url 不 存在 则 返回 url 未 找到 。 
URL 访问 及 返回 的 内 容 如 下 所 示 。 


http://127.0.0.1:5000/ 
=> Welcome to HTTP Mocker! 


http://127.0.0.1:5000/date/hour 
=> URL Not Found 


http://127.0.0.1:5000/date/year 
=> {"year": "2017"} 


15.3.2 ”根据 请 求 方法 过 滤 


json.dumps (MOCK_ MAPPING[url] [ 'default']) 


加 


接 下 来 介绍 针对 请 求 方法 进行 的 过 滤 ， 同 样 也 以 日 期 接口 服务 为 Mock 的 对 象 ， 但 是 这 
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次 只 接收 GET 方法 的 请 求 ， 对 于 非 GET 方法 的 请 求 直 接 返回 错 信息 。 相 应 地 ， 了 映射 关系 配 
置 表 也 需要 进行 修改 ， 更 新 后 的 映射 表格 式 如 下 。 


MOCK MAPPING = { 
"date/year": { 
”GBP 3 忆 ”GENE “201T"}y 
"default": "Method Not Support" 
} 
"date/month": { 
"POST": {"month": "05")}, 
"default": "Method Not Support" 
}, 
"date/day": { 
"GET": {"day": "14"}, 
"default": "Method Not Support" 
BB 
"date/week": { 
"POST": {"week": "Sunday"}, 
"default": "Method Not Support" 
}, 
"default": "URL Not Found" 
} 


新 的 映射 表 中 添加 了 请 求 方法 的 过 滤 字 段 ， 可 以 针对 不 同 的 请 求 方法 设置 不 同 的 响应 内 
容 ， 对 应 地 我 们 的 代码 程序 也 需要 进行 修改 ,修改 后 的 关键 代码 如 下 所 示 。 


Qapp.route('/<path:url>', methods= ['GET', 'POST']) 
def dispatch (url): 
url = url.rstrip('/') 
if url in MOCK MAPPING: 
method mapping = MOCK_ MAPPING[url] 
if request.method in method mapping: 
return json.dumps (method mapping[request.method]) 
else: 
return method mapping['default'] 
else: 
return MOCK MAPPING['default'] 


上 述 代码 中 首先 在 app.route 装饰 器 里 添加 了 methods 参数 ， 表 示 这 个 Mock 可 以 支持 模 
仿 哪些 请 求 方法 ， 样 例 中 只 支持 接收 GET、POST 方 法 。 另 外， 我 们 在 代码 中 添加 了 一 层 针 
对 请 求 方法 的 过 滤 ， 如 果 请 求 方法 在 映射 表 中 有 配置 ， 则 返回 对 应 的 配置 内 容 ， 否 则 直接 返 
回 默 认 的 信息 。 上 述 代码 执行 后 在 浏览 器 中 访问 URL 和 返回 的 内 容 如 下 。 


http://127.0.0.1:5000/date/hour 
=> URL Not Found 


http://127.0.0.1:5000/date/year 
=> {"year": "2017"} 
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http://127.0.0.1:5000/date/month 
=> Method Not Support 


15.3.3 ”根据 请 求 头 过 滤 

对 于 请 求 头 的 过 滤 与 前 面 的 URL、 请 求 方法 的 过 滤 逻 辑 稍微 有 些 差别 ;之 前 的 逻辑 是 不 
设置 URL 或 请 求 方法 时 会 返回 一 个 通用 的 内 容 ， 设 置 后 会 返回 针对 的 内 容 ， 而 请 求 头 在 不 
设置 的 情况 下 会 返回 默认 内 容 ， 设 置 的 情况 下 如 果 匹 配 成 功 也 返回 默认 内 容 ， 而 匹配 失败 的 
情况 下 则 返回 错误 信息 表示 Mock 调用 失败 。 具 体 可 以 通过 表 15-1 来 理解 。 


表 15-1 HTTP Mock 过 滤 规 则 


| Ti 时 | BE | 
返回 通用 返回 值 


也 就 是 说 ， 请 求 URL 和 请 求 方法 必须 得 配置 才能 有 针对 性 的 内 容 ， 而 请 求 头 只 有 配置 
匹配 失败 时 才 返 回 通用 内 容 。 针 对 过 滤 请 求 头 的 功能 我 们 又 对 映射 表 进行 了 改进 ， 得 到 如 下 
的 新 格式 。 


MOCK_MAPPING = { 
"date/year": { 
"GET" : { 
"headers":{ 
SUE 
"host": "localhost:5000" 
} 


"response": {"year": "2017"}, 
"default": "No Mock Header Matched" 
}, 
SEOST™ 区 | 
"headers":{}, 
"response": {"year": "2017"}, 
"default": "No Mock Header Matched" 
} 
"default": "Method Not Support" 
}, 
"default": "URL Not Found" 


} 
同时 我 们 的 代码 也 要 进行 相应 的 更 新 ， 修 改 后 的 支持 请 求 头 过 滤 的 关键 代码 如 下 。 


req_headers = request.headers 
if url in MOCK MAPPING: 
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method mapping = MOCK_MRAPPING [ur1l1] 
if request.method in method mapping: 
resp_mapping = method mapping[request.method] 
if "headers' in respP_mapping and \ 
resp mapping['headers']: 
headers = resp mapping['headers'] 
for k, v in headers.items(): 
if k in req headers: 
if v and v.strip(): 
req Vv = req headers[k] .strip() .lower() 
if req v != v.strip().lower(): 
return resp mapping['default'] 
else: 
return resp_ mapping['default'] 
return json.dumps (resp_mapping['response']) 
else: 
return method mapping['default'] 
else: 
return MOCK MAPPING['default'] 


上 述 代 码 中 添加 了 对 headers 的 检查 ， 如 果 映 射 关系 中 配置 了 headers 信息 ， 则 会 遍历 所 
有 配置 的 header， 如 果 配 置 的 header 头 不 存在 则 返回 默认 信息 ， 如 果 存 在 则 继续 检查 header 
值 是 否 相 等 ，header 值 不 匹配 则 返回 默认 信息 ; 如 果 映 射 关系 中 没有 headers 信息 或 者 所 有 
header 头 都 存在 ， 且 有 内 容 的 header 值 都 匹配 则 返回 对 应 的 配置 信息 。 根 据 代 码 的 逻辑 我 们 
在 运行 之 后 到 浏览 器 中 访问 URL 并 获取 返回 结果 如 下 。 


无 headers 配置 
http://localhost:5000/date/year 
=> {"year": "2017"} 


headers={} 或 headers={"Connection" : ""} 
http://localhost:5000/date/year 
=> {"year": "2017"} 


headers={"Connection" : "keep-alive"} 
http://localhost:5000/date/year 
=> {"year": "2017"} 


headers={"Connection" : "2keep-alive2"} 
http://localhost:5000/date/year 
=> No Mock Header Matched 


15.3.4 ”根据 请 求 数据 过 滤 

最 后 要 介绍 的 是 对 请 求 数据 的 过 滤 ， 即 对 请 求 发 送 过 来 的 数据 内 容 进 行 过 滤 ， 符 合 配置 
内 容 的 请 求 会 有 对 应 的 返回 内 容 ， 和 否则 返回 默认 的 内 容 。 请 求 数据 的 过 滤 逻 辑 与 请 求 头 的 过 
滤 逻 辑 一 样 ， 即 它 不 是 必 选 的 配置 ， 没 有 该 配置 的 时 候 也 能 获取 对 应 的 返回 内 容 ; 而 一 旦 配 
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置 之 后 又 没有 匹配 成 功 则 会 返回 默认 值 。 
按照 惯例 需要 对 映射 配置 表 进行 更 新 ， 这 次 需要 添加 请 求 数据 字段 ， 新 的 映射 表 的 格式 
如 下 。 


MOCK_ MAPPING = { 
"date/year": { 
“GET" : 
"headers":{ 
"user-agent": "" 


}, 
"data":{ 
"current": true 


} 


"response": {"year": "2017"}, 
"default": "NO Mock Header Matched" 
} 

"POST" : 1{ 
"headers":{ 
} 
"data":{ 
}, 
"response": {"year": "2017"}, 
"default": "No Mock Header Matched" 


}, 
"default": "Method Not Support" 
} 
"default": "URL Not Found" 
} 


新 增 data 字段 的 配置 和 使 用 逻辑 与 请 求 头 基本 上 是 一 致 的 ， 所 以 关于 请 求 数据 的 过 滤 代 
码 也 非常 相似 ， 只 是 在 细节 上 比 请 求 头 要 多 处 理 些 内 容 。 例 如 ，POST 请 求 时 的 数据 可 能 会 
有 多 种 不 同形 式 ， 我 们 需要 进行 针对 性 的 处 理 。 由 于 支持 请 求 数 据 过 滤 的 代码 较 多 ,我们 
来 分 段 进行 介绍 ， 如 下 代码 展示 的 是 针对 POST 请 求 数据 的 不 同类 型 进行 请 求 数 据 获 取 的 
流程 。 


url_encode = 'application/x-www-form-urlencoded' 
from data = 'multipart/form-data’' 

data = resp mapping['data'] 

if request.method == 'POST': 


content type = req headers.get['Content-Type'] 
if content type.startswith(url encode): 
req data = request.form 
elif content type.startswith (from data): 
req data = request.form 
req file = request .files 
else: 
req data = request.data 
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if data.strip() != req data: 
return resp mapping['default'] 
else: 
req data = request.args 


从 代码 中 可 以 看 到 ， 如 果 请 求 为 POST 类 型 ， 则 会 判断 其 Content-Type 内 容 ， 如 果 为 
x-www-form-urlencoded， 则 从 form 对 象 中 获取 请 求 数据 ; 如 果 为 multipart/form-data， 则 从 
form 和 files 对 象 获 取 请 求 数据 ， 否 则 直接 从 data 对 象 中 获取 原始 的 请 求 数据 文本 ; 而 如 果 
请 求 类 型 不 是 POST， 则 会 从 args 对 象 中 获取 请 求 参数 。 

在 获取 到 请 求 数据 之 后 ， 还 要 对 请 求 数据 进行 检查 和 匹配 ， 有 具体 的 匹配 代码 如 下 。 

for k, v in data.items () : 

if k in req data: 
if Vv and v.strip() : 
req v = req_data[k].strip() .lower() 
if req v != Vv.strip().lower(): 
return resp_mapping['default'] 
elif Kk Ln req Ble: 
file obj = req file[k] 
if Vv.strip() != file_ obj .filename: 
return resp mapping['default'] 
else: 
return resp mapping['default'] 
return json.dumps (resp_mapping['response']) 


上 述 代 码 中 先 遍历 映射 配置 表 中 的 data 数据 ， 并 检查 配置 的 数据 项 在 请 求 数据 req_data 
中 是 否 存 在 ， 如 果 存 在 则 进一步 检查 该 配置 的 数据 项 是 否 有 内 容 ， 数 据 项 有 内 容 则 需要 进行 
匹配 ， 匹 配 不 成 功 则 返回 默认 内 容 。 数 据 项 如 果 在 请 求 数 据 req_data 中 不 存在 ， 则 会 在 上 传 
文件 数据 req_file 中 进行 检查 ， 如 果 数 据 项 存在 于 req_file 中 ， 则 会 检查 其 内 容 是 否 为 对 应 文 
件 对 象 的 flename， 文件 名 不 一 致 则 返回 默认 内 容 ; 仅 当 映 射 配置 表 中 没有 请 求 数 据 过 滤 或 
请 求 数据 过 滤 正 确 的 情况 下 才 会 返回 对 应 的 配置 内 容 。 

到 这 里 为 止 ,关于 HTTP Mock 简单 实现 的 介绍 已 经 结束 ， 本 节 中 的 HTTP Mock 只 是 一 
个 样 例 ， 如 果 想 要 在 日 常 测试 工作 中 正式 使 用 该 工具 ， 还 需要 进一步 完善 其 功能 。 例 如 ， 映 
射 配置 表 可 以 存放 在 数据 库 中 ， 同 时 可 以 提供 简单 的 UI 界面 来 添加 映射 规则 和 数据 。 本 节 
的 完整 代码 可 以 从 https://github.com/five3/python-Selenium-book 下 载 。 
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结束 语 


不 知 不 觉 中 已 经 完成 了 本 书 的 全 部 内 容 ， 这 本 书 在 内 容 上 除了 包含 Web 自动 化 测试 的 相 
关 技术 外 ， 在 开头 也 使 用 了 相对 的 篇 幅 介绍 了 如 何 去 实 践 自动 化 测试 ， 理 解 自动 化 测试 的 真 
正 目的 与 意义 ， 避 免 言 目 学 习 和 使 用 自动 化 测试 技术 。 
而 在 自动 化 测试 技术 方面 ， 除 了 介绍 UI 自动 化 测试 工具 Selenium 之 外 ， 还 介绍 了 Web 
API 工具 的 开发 与 简易 Web 服务 的 开发 ， 并 且 围 绕 这 些 技 术 的 相关 基础 知识 也 在 各 章节 中 进 
行 了 穿插 介绍 。 

最 后 ， 如 果 读 者 既 喜 欢 Python， 又 从 事 或 期 望 从事 自 动 化 测试 的 相关 工作 ， 那 么 本 书 
可 能 是 你 和 人 门 或 者 实践 过 程 中 的 一 个 好 伙伴 。 本 书 中 的 所 有 样 例 代码 均 可 在 GitHub(https:// 
github.com/five3/python-Selenium-book) 上 进行 访问 和 下 载 。 另 外 ， 对 于 已 经 成 型 的 工具 或 杠 
架 ， 将 会 额外 归档 在 独立 的 仓库 ， 并 在 后 期 进行 持续 升级 。 同 时 基于 本 书 作者 还 建立 了 相关 
的 技术 小 组 ， 读 者 可 以 加 入 小 组 来 共同 学 习 和 提高 测试 技能 。 


